L'API Domain Shared Contacts consente alle applicazioni di recuperare e aggiornare i contatti esterni condivisi con tutti gli utenti di un dominio Google Workspace. I contatti condivisi sono visibili a tutti gli utenti di un dominio Google Workspace e tutti i servizi Google hanno accesso all'elenco contatti.
Utilizza l'API Domain Shared Contacts per creare, modificare o eliminare i contatti condivisi e per cercare i contatti che corrispondono a criteri specifici.
L'API Domain Shared Contacts è disponibile solo per gli account Google Workspace. Per utilizzare l'API, attiva l'API Domain Shared Contacts nella Console di amministrazione. L'applicazione delle modifiche può richiedere fino a 24 ore nel completamento automatico e nel gestore dei contatti.
Questo documento fornisce informazioni di base sull'API Domain Shared Contacts ed esempi per la gestione dei contatti utilizzando XML e HTTP. Per saperne di più, consulta le librerie client.
Pubblico
Questo documento è destinato agli sviluppatori che scrivono applicazioni client che manipolano gli elenchi di contatti Google utilizzando HTTP e XML. Presuppone la conoscenza del protocollo delle API Google Data.
Gli utenti Linux e macOS possono provare gli esempi in questo documento utilizzando curl o wget. Consulta Utilizzare curl con le API Google Data.
Principi
L'API Domain Shared Contacts segue i principi delle API Google Data. Le API Google Data si basano su Atom 1.0, RSS 2.0 e sul protocollo di pubblicazione Atom.
Specificare una versione
Tutte le richieste inviate utilizzando l'API Domain Shared Contacts devono specificare la versione 3.0:
GData-Version: 3.0
Se non riesci a impostare le intestazioni HTTP, specifica v=3.0 come parametro di query.
È consigliato il metodo dell'intestazione HTTP.