L'API Domain Shared Contacts consente alle tue 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.
La tua applicazione può utilizzare l'API Domain Shared Contacts per creare contatti condivisi, modificare o eliminare contatti condivisi esistenti ed eseguire query per i contatti condivisi che corrispondono a un determinato criterio.
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 ai contatti condivisi può richiedere fino a 24 ore nel completamento automatico dell'indirizzo email e nel gestore dei contatti.
Oltre a fornire informazioni di base 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 vogliono scrivere applicazioni client in grado di manipolare gli elenchi di contatti di Google utilizzando HTTP e XML. Questo documento presuppone che tu conosca i principi fondamentali del protocollo Google Data APIs.
Se utilizzi un sistema operativo UNIX e vuoi provare gli esempi in questo documento senza scrivere codice, utilizza le utilità della riga di comando UNIX curl o wget. Scopri come utilizzare cURL con i servizi Google Data.
Principi
Questa versione dell'API Domain Shared Contacts segue i principi delle API Google Data. Le API Google Data si basano sui formati di syndication Atom 1.0 e RSS 2.0, oltre che sul protocollo di pubblicazione Atom.
Specificare 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 riesci a impostare le intestazioni HTTP, puoi specificarev=3.0 come parametro di ricerca nell'URL, ma è consigliato il metodo dell'intestazione HTTP.