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 Google Data.

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 del 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 qualsiasi di questi elementi, il server rifiuta la voce.

Supporto 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 saperne di più, consulta Informazioni su autenticazione e autorizzazione.

  • Con un comando GET, rel="http://schemas.google.com/contacts/2008/rel#photo" aggiunge la funzionalità di lettura della foto associata al contatto. Puoi utilizzare l'URL specificato in href per leggere l'ultima versione della foto associata al contatto. Il link non viene visualizzato se non è presente una foto 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 funzionalità di aggiornamento o eliminazione di 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 suo ID.
deleted="true" Significa 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.