Ricevere contatti condivisi

Richiedi i contatti utente condivisi nei seguenti modi:

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

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

Recuperare 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: Il tuo dominio. Ad esempio, example.com.
    • PROJECTION: il valore della proiezione. Per i valori supportati, vedi Valori di proiezione.

    Il server restituisce un codice di stato HTTP 200 OK e un feed Atom 1.0. L'esempio seguente mostra un feed dei contatti con una 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. I feed restituiscono un massimo di 10 MB in una singola risposta. Per ottenere l'elenco completo, segui ripetutamente il link Avanti nel feed restituito.

Recuperare i contatti condivisi utilizzando i parametri di query

Richiedi i contatti che corrispondono a criteri specifici, ad esempio quelli aggiornati dopo una determinata data. Le query di ricerca nel testo e le ricerche di indirizzi email non sono supportate. Per tutti i parametri di query, consulta la Guida di riferimento dell'API Domain Shared Contacts.

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

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

    Sostituisci quanto segue:

    Ad esempio, per ottenere le voci aggiornate dopo il 16 marzo 2022 per example.com, aggiungi il parametro updated-min:

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

    Il server restituisce un codice di stato HTTP 200 OK e un feed con eventuali corrispondenze.

  2. I feed restituiscono un massimo di 10 MB in una singola risposta. Per ottenere l'elenco completo, segui ripetutamente il link Avanti nel feed restituito.

Monitorare le modifiche incrementali

Per monitorare le modifiche a un elenco di contatti condiviso del dominio: 1. Registra il valore dell'elemento <updated> del feed. 1. Richiedi i contatti modificati impostando updated-min su quel valore <updated> e impostando showdeleted su true.

Ottenere un singolo contatto condiviso

Per ottenere un contatto specifico, utilizza il link personale del contatto, che puoi trovare nel feed dei contatti condivisi. Per saperne di più, vedi Recuperare tutti i contatti condivisi.

  1. Per ottenere un contatto specifico, invia una richiesta HTTP GET al link personale del contatto: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Sostituisci quanto segue:
  • DOMAIN: il tuo dominio, ad esempio example.com.
  • PROJECTION: il valore della proiezione. Per i valori supportati, vedi Valori di proiezione.
  • SELF_LINK: Il valore numerico univoco del contatto.

Il server restituisce un codice di stato HTTP 200 OK e la voce di contatto.

Ad esempio, per ottenere un contatto con il self link https://www.google.com/m8/feeds/contacts/example.com/full/12345:

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

Passaggi successivi