Elementi dei contatti condivisi

L'API Domain Shared Contacts utilizza elementi standard dell'API di dati di Google specifici per i contatti condivisi.

Un contatto assume la forma di un Tipo di contatto, che rappresentano una persona, una sede, come un club o un ristorante, dell'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 simile al seguenti:

<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 a il tipo di contatto. Per gli elementi seguenti, devi fornire un valore 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 di questi elementi, il server rifiuta il valore .

Assistenza per Foto

In combinazione con le proprietà standard come self-service o modifica, puoi usare rel valori per gli elementi atom:link. Quando utilizzi i link a foto, inserisci il token di autorizzazione è necessario specificare l'intestazione HTTP. Per ulteriori informazioni, vedi Scopri di più su autenticazione e autorizzazione.

  • Con un comando GET, rel="http://schemas.google.com/contacts/2008/rel#photo" aggiunge capacità di leggere la foto associata al contatto. Puoi utilizzare lo URL specificato in href per leggere l'ultima versione della foto associata con il contatto. Il link non viene mostrato in assenza di immagini 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 di aggiornare o eliminare una foto locale associata a il 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" />

gContact spazio dei nomi

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

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

gContact:groupMembershipInfo strutture

Proprietà Descrizione
href Identifica il gruppo a cui appartiene o apparteneva il contatto. La a cui fa riferimento il gruppo mediante l'ID.
deleted="true" Significa che l'appartenenza al gruppo è stata rimossa per il contatto. Questo viene incluso solo se showdeleted è specificato come parametro di query, altrimenti groupMembershipInfo per i gruppi a cui un contatto non appartiene più non vengono restituiti.