Com a API Domain Shared Contacts, os aplicativos podem receber e atualizar contatos externos compartilhados com todos os usuários em um domínio do Google Workspace. Os contatos compartilhados ficam visíveis para todos os usuários de um domínio do Google Workspace, e todos os Serviços do Google têm acesso à lista de contatos.
Use a API Domain Shared Contacts para criar, editar ou excluir contatos compartilhados e consultar contatos que atendam a critérios específicos.
A API Domain Shared Contacts está disponível apenas para contas do Google Workspace. Para usar a API, ative a API Domain Shared Contacts no Admin Console. As mudanças podem levar até 24 horas para aparecer no preenchimento automático e no gerenciador de contatos.
Este documento apresenta informações básicas sobre a API Domain Shared Contacts e exemplos para gerenciar contatos usando XML e HTTP. Para saber mais, consulte as bibliotecas de cliente.
Público-alvo
Este documento é destinado a desenvolvedores que criam aplicativos cliente que manipulam listas de contatos do Google usando HTTP e XML. Ele pressupõe conhecimento do protocolo das APIs Data do Google.
Os usuários de Linux e macOS podem testar os exemplos neste documento usando curl ou wget. Consulte Usar curl com as APIs de dados do Google.
Princípios
A API Domain Shared Contacts segue os princípios das APIs de dados do Google. As APIs Data do Google são baseadas no Atom 1.0, no RSS 2.0 e no protocolo de publicação Atom.
Especificar uma versão
Todas as solicitações enviadas usando a API Domain Shared Contacts precisam especificar a versão 3.0:
GData-Version: 3.0
Se não for possível definir cabeçalhos HTTP, especifique v=3.0 como um parâmetro de consulta.
O método de cabeçalho HTTP é recomendado.