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.

Un contatto assume la forma di un tipo di contatto esteso, che rappresenta una persona, un luogo, come un club o un ristorante, o un'organizzazione. Il tipo di contatto viene visualizzato in XML come un 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, puoi fornire un attributo rel o label, ma non entrambi:

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

Quando crei o aggiorni un contatto condiviso, se fornisci entrambi i valori rel e label o nessuno dei due per uno di questi elementi, il server rifiuta l'inserimento.

Assistenza per Foto

Insieme ai valori delle proprietà standard, come "self-edit" o "modifica", puoi utilizzare i valori rel per gli elementi atom:link. Se si utilizzano i link a foto, è necessario specificare il token di autorizzazione nell'intestazione HTTP. Per maggiori informazioni, consulta Informazioni 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 l'ultima versione della foto associata al contatto. Il link non viene visualizzato se non è presente un'immagine del 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 viene 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 a cui apparteneva il contatto. Il gruppo è indicato dal suo ID.
deleted="true" Significa che l'appartenenza al gruppo del contatto è stata rimossa. Questo attributo è incluso solo se showdeleted è specificato come parametro di ricerca, altrimenti non viene restituito groupMembershipInfo per i gruppi a cui un contatto non appartiene più.