A API Domain Shared Contacts permite que seus apps recebam e atualizem 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.
Seu app pode usar a API Domain Shared Contacts para criar, editar ou excluir contatos compartilhados e consultar contatos compartilhados que correspondem a um critério específico.
A API Domain Shared Contacts só está disponível para contas do Google Workspace. Para usar a API, ative a API Domain Shared Contacts no Admin Console. As mudanças nos contatos compartilhados podem levar até 24 horas para serem refletidas no preenchimento automático do endereço de e-mail e no gerenciador de contatos.
Além de fornecer informações sobre os recursos da API Domain Shared Contacts, este documento oferece exemplos sobre como gerenciar contatos usando XML e HTTP. Depois de ler este documento, você pode aprender mais sobre como interagir com a API usando nossas bibliotecas de cliente.
Público-alvo
Este documento é destinado a desenvolvedores que querem criar aplicativos clientes que possam manipular as listas de contato do Google usando HTTP e XML. Este documento pressupõe que você entenda os conceitos básicos por trás do protocolo das APIs de dados do Google.
Se você estiver usando um sistema operacional UNIX e quiser testar os exemplos deste documento sem escrever nenhum código, use os utilitários de linha de comando UNIX curl ou wget. Saiba como usar o cURL com os Serviços de dados do Google.
Princípios
Esta versão da API Domain Shared Contacts segue os princípios das APIs Data do Google. As APIs de dados do Google são baseadas nos formatos de distribuição Atom 1.0 e RSS 2.0, além do 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 da API:
GData-Version: 3.0
Se não for possível definir cabeçalhos HTTP, especifique v=3.0 como um parâmetro de consulta no
URL, mas o método de cabeçalho HTTP é recomendado.