Criar uma marca

Cria uma marca: o objeto de nível superior da Social API. A uma marca pertencem as contas sociais que você conecta a ela e todas as publicações feitas a partir dessas contas. Nenhuma outra operação da Social API pode ser chamada até que exista pelo menos uma marca, portanto esta é a primeira requisição em qualquer integração com a Social API.

Caso de uso: integração de um cliente à publicação em redes sociais. Quando um cliente se cadastrar no seu produto, crie uma marca para cada empresa para a qual ele quiser publicar. Armazene o socialProfile.id retornado no seu próprio registro dessa empresa: ele é o token de caminho brandId em POST /social/brands/{brandId}/connections/link e GET /social/brands/{brandId}/posts, e o campo socialProfileId do corpo de cada publicação que você criar. Em seguida, encaminhe o usuário pelo link de conexão hospedado para cada plataforma na qual ele quiser publicar.

Observações.

• O corpo da requisição deve estar encapsulado em um objeto input. Todas as operações de escrita na Social API são encapsuladas dessa forma, com uma exceção: o link de conexão aceita um corpo sem encapsulamento.
• Verifique success, não o status HTTP. Uma falha de validação — um profileName ausente ou um timezone.tzCode desconhecido — retorna como HTTP 200 com success: false e o motivo em error. Considere a chamada bem-sucedida somente quando success for true.
• Somente profileName e timezone são obrigatórios. businessIntent e categories têm como valores padrão general e uma lista vazia, respectivamente, portanto uma integração que não tenha equivalentes desses campos pode omiti-los completamente.
• timezone.tzCode não é decorativo. Uma publicação agendada com scheduleDate + scheduleTime é interpretada no fuso horário da marca, não no de quem faz a chamada nem em UTC. Alterá-lo posteriormente não modifica os horários das publicações já agendadas.
• A marca sempre pertence à conta associada à chave de API. Não é possível criar uma marca em outra conta: qualquer identificador de conta no corpo é ignorado.
• Os IDs de marca são UUIDs simples. Eles não são os IDs relay em Base64 usados por Locations e Posts de locais, portanto não os codifique nem decodifique. O mesmo ID aparece como o token de caminho brandId e como o campo socialProfileId do corpo: brandId é sempre apenas um token de URL, nunca um campo do corpo.
• Não há limite de marcas em um plano de API. As marcas são ilimitadas e não têm o uso contabilizado, portanto esta chamada nunca é recusada por atingir um limite e você não precisa verificar a capacidade disponível antes de criar uma. O que tem o uso contabilizado são as conexões — uma conta social vinculada a uma marca em uma rede. Consulte Planos e complementos para conhecer as faixas de conexões e o preço de um pacote de conexões, e GET /social/limits para consultar sua capacidade disponível de conexões antes de encaminhar um usuário por um link de conexão.

Operação de escrita: não executada na conta real. A requisição e a resposta exibidas são construídas a partir do esquema da API.