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 e eseguire query sui contatti condivisi che corrispondono a criteri specifici.
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. Potrebbero trascorrere fino a 24 ore prima che le modifiche ai contatti condivisi vengano applicate nel completamento automatico dell'indirizzo email e nel gestore dei contatti.
Oltre a fornire informazioni 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 è rivolto agli sviluppatori che vogliono scrivere applicazioni client che possono manipolare gli elenchi di contatti di Google utilizzando HTTP e XML. Questo documento presuppone che tu abbia compreso i concetti fondamentali alla base del protocollo delle API di dati di Google.
Se utilizzi un sistema operativo UNIX e vuoi provare gli esempi in questo documento senza scrivere codice, utilizza le utilità a riga di comando UNIX curl o wget. Scopri come utilizzare cURL con i servizi Google Data.
Princìpi
Questa versione dell'API Domain Shared Contacts segue i principi delle API di dati di Google. Le API di Google Data si basano sui formati di syndication Atom 1.0 e RSS 2.0 oltre che sul protocollo Atom Publishing.
Specifica una versione
Ogni richiesta inviata 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 specificare v=3.0 come parametro di query nell'URL, ma è consigliabile utilizzare il metodo dell'intestazione HTTP.