L'API dei contatti condivisi del dominio consente alle applicazioni di scaricare e aggiornare contatti condivisi con tutti gli utenti di un dominio Google Workspace. Condivisa contatti sono visibili a tutti gli utenti di un dominio Google Workspace e a tutti i servizi hanno accesso all'elenco contatti.
La tua applicazione può utilizzare l'API dei contatti condivisi del dominio per creare contatti condivisi, modificare o eliminare contatti condivisi esistenti ed eseguire query per i contatti condivisi che corrispondono a criteri specifici.
L'API Domain Shared Contacts è disponibile solo per gli account Google Workspace. Per utilizzare l'API, abilitare l'API Domain Shared Contacts nella Console di amministrazione. Possono essere necessarie fino a 24 ore prima che le modifiche ai contatti condivisi siano visibili nell'email il completamento automatico degli indirizzi e il gestore contatti.
Oltre a fornire informazioni sulle capacità del API Domain Shared Contacts, questo documento fornisce esempi su come gestire utilizzando XML e HTTP. Dopo aver letto questo documento, puoi scoprire di più sull'interazione con l'API tramite librerie client.
Pubblico
Questo documento è rivolto agli sviluppatori che desiderano scrivere applicazioni client in grado di manipolare gli elenchi di contatti di Google tramite HTTP e XML. In questo documento si presuppone che tu abbia compreso il i concetti fondamentali del protocollo delle API di dati di Google.
Se utilizzi un sistema operativo UNIX e vuoi provare gli esempi in questo documento senza scrivere alcun codice, utilizza le utilità della riga di comando UNIX curl o wget. Scopri come Utilizzare cURL con i servizi dati di Google.
Princìpi
Questa versione dell'API Domain Shared Contacts segue i principi della API di dati di Google. Le API di dati di Google si basano sui formati di syndication Atom 1.0 e RSS 2.0 oltre all'Atom Publishing Protocol.
Specifica una versione
Per ogni richiesta inviata utilizzando l'API dei contatti condivisi del dominio deve essere specificata la versione 3.0 dell'API:
GData-Version: 3.0
Se non puoi impostare le intestazioni HTTP, puoi specificare v=3.0
come parametro di ricerca in
l'URL, ma è consigliato il metodo dell'intestazione HTTP.