Ricevere contatti condivisi

Puoi richiedere i contatti degli utenti condivisi in diversi modi:

  • Tutti i contatti condivisi
  • Un insieme di contatti che corrispondono a criteri specificati
  • Un singolo contatto condiviso
  • Una foto per un contatto

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

Visualizzare tutti i contatti condivisi

  1. Per ottenere tutti i contatti condivisi, invia una richiesta HTTP GET 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 un 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 recuperare l'intero elenco contatti, segui ripetutamente il link Avanti del feed restituito finché non lo vedi più nel feed restituito.

Ottenere i contatti condivisi utilizzando i parametri di query

Puoi richiedere un insieme di contatti che corrispondono a criteri specificati, ad esempio richiedere i contatti aggiornati dopo una determinata data. Non è disponibile assistenza per le query di testo completo o per l'individuazione di un contatto tramite l'indirizzo email. Per un elenco completo dei parametri di query supportati, consulta Guida di riferimento dell'API Domain Shared Contacts.

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

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

    Sostituisci quanto segue:

    Ad esempio, per ottenere tutte le voci dei contatti condivisi del dominio aggiornate dopo il 16 marzo 2022 per example.com, invia una richiesta HTTP all'URL del feed dei contatti condivisi 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 la richiesta GET, il server restituisce un codice di stato HTTP 200 OK e un feed contenente tutti i contatti condivisi del dominio che sono stati creati o aggiornati dopo la data specificata.

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

Monitorare le modifiche incrementali

Per monitorare le modifiche incrementali a un elenco contatti condiviso del dominio, svolgi i seguenti passaggi: 1. Quando invii una richiesta per un feed, tieni traccia del valore dell'elemento <updated> del feed. 1. Puoi ottenere solo i contatti condivisi del dominio che sono cambiati dalla richiesta precedente impostando il parametro di query updated-min sul valore <updated> e impostando showdeleted su true.

Ricevere un singolo contatto condiviso

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

  1. Per ottenere un contatto condiviso del dominio specifico, invia una richiesta HTTP GET al link autoreferenziale 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 il link a se stesso 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