Ricevere contatti condivisi

Puoi richiedere i contatti condivisi degli utenti in vari modi:

  • Tutti i contatti condivisi
  • Un insieme di contatti che corrispondono a un criterio specificato
  • Un unico contatto condiviso
  • Una foto per un contatto

Per impostazione predefinita, le voci di un feed non vengono ordinate.

Scarica tutti i contatti condivisi

  1. Per ricevere tutti i contatti condivisi, invia una richiesta GET HTTP all'URL del feed dei contatti:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    Sostituisci quanto segue:

    • DOMAIN: l'URL del tuo dominio, ad esempio example.com.
    • PROJECTION: il valore di proiezione che specifica gli elementi gd:extendedProperty. Per un elenco dei valori supportati, consulta Valori di proiezione.

    Il feed restituisce un codice di stato HTTP 200 OK e un feed Atom 1.0 standard contenente i contatti. Di seguito è riportato un esempio di feed di contatti con una sola voce:

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. Il feed non restituisce più di 10 MB in una singola risposta. Per ottenere l'intero elenco dei contatti, segui ripetutamente il link Avanti del feed restituito finché non lo vedi più nel feed di reso.

Ricevere contatti condivisi utilizzando i parametri di ricerca

Puoi richiedere una serie di contatti che corrispondono a criteri specificati, ad esempio la richiesta di contatti aggiornati dopo una determinata data. Non è disponibile alcun supporto per le query a testo intero o per l'individuazione di un contatto tramite l'indirizzo email. Per un elenco completo dei parametri di ricerca supportati, consulta la guida di riferimento dell'API Domain Shared Contacts.

  1. Invia una richiesta HTTP GET all'URL del feed di contatti con un parametro definito:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    Sostituisci quanto segue:

    Ad esempio, per aggiornare tutte le voci dei contatti condivisi del dominio dopo il 16 marzo 2022 per example.com, invia una richiesta HTTP all'URL del feed dei contatti condiviso del dominio e aggiungi il parametro updated-min all'URL della richiesta:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Quando invii questa richiesta GET, il server restituisce un codice di stato HTTP 200 OK e un feed contenente gli eventuali contatti condivisi del dominio creati o aggiornati dopo la data specificata.

  2. Il feed non restituisce più di 10 MB in una singola risposta. Per ottenere l'intero elenco dei contatti con i criteri specificati, segui ripetutamente il link Avanti del feed restituito finché non lo vedi più nel feed di reso.

Monitorare le modifiche incrementali

Per monitorare le modifiche incrementali a un elenco di contatti condivisi del dominio, procedi nel seguente modo: 1. Quando invii una richiesta di feed, tieni traccia del valore dell'elemento <updated> del feed. 1. Puoi visualizzare solo i contatti condivisi del dominio che sono stati modificati dopo la richiesta precedente impostando il parametro di ricerca updated-min su quel valore <updated> e impostando showdeleted su true.

Ottieni un singolo contatto condiviso

Per ottenere un singolo contatto condiviso, devi utilizzare il link autonomo del contatto. Puoi ottenere il link autonomo del contatto condiviso solo individuando la voce del contatto nel feed dei contatti condivisi. Se non sai quale valore utilizzare per il link autonomo, consulta Recuperare tutti i contatti e Recuperare i contatti utilizzando i parametri di ricerca.

  1. Per ottenere un contatto condiviso del dominio specifico, invia una richiesta GET HTTP al link autonomo di un contatto: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    Sostituisci quanto segue:
  • DOMAIN: l'URL del tuo dominio, ad esempio example.com.
  • PROJECTION: il valore di proiezione che specifica gli elementi gd:extendedProperty. Per un elenco dei valori supportati, consulta Valori di proiezione.
  • SELF_LINK: un valore numerico univoco che rappresenta un singolo contatto condiviso, ad esempio 12345.

Il server restituisce quindi un codice di stato HTTP 200 OK e una voce contenente il contatto.

Ad esempio, per ottenere un contatto condiviso del dominio con link autonomo impostato su https://www.google.com/m8/feeds/contacts/example.com/full/12345, invia la seguente richiesta HTTP:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

Passaggi successivi