L'API Domain Shared Contacts consente alle tue applicazioni di ricevere 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 dei contatti.
L'applicazione può utilizzare l'API Domain Shared Contacts per creare contatti condivisi, modificare o eliminare i contatti condivisi esistenti ed eseguire query per trovare contatti condivisi che corrispondono a un determinato criterio.
L'API Domain Shared Contacts è disponibile solo per gli account Google Workspace. Per utilizzare l'API, abilita l'API Domain Shared Contacts nella Console di amministrazione. Possono essere necessarie fino a 24 ore prima che le modifiche ai contatti condivisi vengano applicate al completamento automatico dell'indirizzo email e in Gestione contatti.
Oltre a fornire informazioni generali sulle funzionalità dell'API Domain Shared Contacts, questo documento offre esempi su come gestire i contatti utilizzando XML e HTTP. Dopo aver letto questo documento, puoi scoprire di più sull'interazione con l'API utilizzando le nostre librerie client.
Pubblico
Questo documento è destinato agli sviluppatori che desiderano scrivere applicazioni client in grado di manipolare gli elenchi dei contatti di Google utilizzando HTTP e XML. Questo documento presuppone la conoscenza dei concetti fondamentali del protocollo delle API di dati di Google.
Se utilizzi un sistema operativo UNIX e vuoi provare gli esempi riportati in questo documento senza scrivere codice, utilizza le utilità della riga di comando UNIX curl o wget. Scopri come utilizzare cURL con i servizi di dati di Google.
Princìpi
Questa versione dell'API Domain Shared Contacts segue i principi delle 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 che sul protocollo di pubblicazione Atom.
Specifica una versione
Ogni richiesta che invii utilizzando l'API Domain Shared Contacts deve specificare 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 nell'URL, ma ti consigliamo di utilizzare il metodo dell'intestazione HTTP.