Elementi dei contatti condivisi

L'API Domain Shared Contacts utilizza gli elementi standard dell'API Google Data e gli elementi specifici per i contatti condivisi.

Una voce di contatto assume la forma di un Tipo di contatto esteso, che rappresenta una persona, un luogo, ad esempio un club o un ristorante, o un'organizzazione. Il tipo di contatto viene visualizzato in XML come elemento <atom:entry> che contiene vari elementi di estensione dello spazio dei nomi dei dati di Google.

L'elemento category che indica che la voce è un contatto ha il seguente aspetto:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Nell'API Domain Shared Contacts, diversi elementi sono leggermente più restrittivi rispetto al tipo di contatto. Per i seguenti elementi, fornisci un attributo rel o un attributo label, ma non entrambi:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Quando crei o aggiorni un contatto condiviso, se fornisci sia rel sia label o nessuno dei due per uno di questi elementi, il server rifiuta la voce.

Assistenza di Foto

Insieme ai valori delle proprietà standard come self o edit, puoi utilizzare i valori rel per gli elementi atom:link. Quando utilizzi i link alle foto, devi specificare il token di autorizzazione nell'intestazione HTTP. Per ulteriori informazioni, consulta Scopri di più su autenticazione e autorizzazione.

  • Con un comando GET, rel="http://schemas.google.com/contacts/2008/rel#photo" aggiunge la possibilità di leggere la foto associata al contatto. Puoi utilizzare l'URL specificato in href per leggere la versione più recente della foto associata al contatto. Il link non viene visualizzato se non è presente un'immagine per il contatto.

Esempio:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • Con un comando PUT o DELETE, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" aggiunge la possibilità di aggiornare o eliminare una foto locale associata al contatto.

Esempio:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

Spazio dei nomi gContact

L'URL dello spazio dei nomi XML per gContact è http://schemas.google.com/contact/2008.

In questo spazio dei nomi è definito un elemento che rappresenta un gruppo a cui appartiene il contatto.

gContact:groupMembershipInfo strutture

Proprietà Descrizione
href Identifica il gruppo a cui appartiene o apparteneva il contatto. Il gruppo viene fatto riferimento tramite il relativo ID.
deleted="true" Indica che l'appartenenza al gruppo è stata rimossa per il contatto. Questo attributo viene incluso solo se showdeleted è specificato come parametro di query, altrimenti groupMembershipInfo per i gruppi a cui un contatto non appartiene più non viene restituito.