Importante: esegui la migrazione dei tuoi script dal servizio Contatti al servizio avanzato dell'API People prima che Apps Script arresti il servizio Contatti a marzo 2023.
Apps Script ha ritirato il servizio Contatti il 16 dicembre 2022. Utilizza invece il servizio avanzato API People. L'API People utilizza un protocollo JSON più recente e offre funzionalità avanzate, come l'unione di contatti e profili.
Utilizza questa guida per scoprire quali metodi del servizio Contatti non hanno equivalenti nel servizio avanzato dell'API People, scoprire cosa puoi utilizzare e trovare esempi di codice per la migrazione delle attività comuni. Per ulteriori informazioni, consulta la guida alla migrazione dell'API Contacts.
Metodi senza equivalenti dell'API People
Di seguito sono elencati i metodi getContacts
nel servizio Contatti che non offrono modalità equivalenti per cercare i contatti nel servizio avanzato People API. Con il servizio avanzato dell'API People, puoi eseguire una ricerca in base ai campi names
, nickNames
, emailAddresses
, phoneNumbers
e organizations
di un contatto provenienti dall'origine CONTACT
.
Metodi senza equivalenti |
---|
|
Di seguito sono elencati i metodi getContacts
del servizio Contatti che utilizzano un parametro label
aggiuntivo. Puoi utilizzare searchContacts
del servizio avanzato dell'API People per recuperare i contatti in base al campo equivalente,
ma non puoi limitare la ricerca a un'etichetta specifica.
Metodi con equivalenti parziali |
---|
|
Funzionalità aggiuntive disponibili con l'API People
Quando esegui la migrazione al servizio avanzato dell'API People, puoi accedere alle seguenti funzionalità dell'API People che non sono disponibili nel servizio Contatti:
- Specificare l'origine dati: quando cerchi informazioni su una persona, puoi specificare dove eseguire la ricerca, ad esempio un contatto o un profilo Google.
- Cerca persone in base a una stringa di query: puoi ottenere un elenco di profili e contatti che corrispondono a una stringa specifica.
- Richieste batch: puoi raggruppare le chiamate API People per ridurre i tempi di esecuzione dello script.
Esempi di codice per attività comuni
In questa sezione sono elencate le attività comuni del servizio Contatti. Gli esempi di codice mostrano come creare le attività utilizzando il servizio avanzato dell'API People.
Ottieni un gruppo di contatti per nome
Il seguente esempio di codice mostra come ottenere un gruppo di contatti in base al nome, che equivale a getContactGroup(name)
nel servizio Contatti.
Trovare un contatto tramite indirizzo email
Il seguente esempio di codice mostra come ottenere un contatto tramite il suo indirizzo email, che equivale a getContact(emailAddress)
nel servizio Contatti.
Recupera tutti i contatti
Il seguente esempio di codice mostra come recuperare tutti i contatti di un utente, l'equivalente a getContacts()
nel servizio Contatti.
Conoscere il nome completo di un contatto
Il seguente esempio di codice mostra come ottenere il nome completo di un contatto, che è l'equivalente a getFullName()
nel servizio Contatti.
Recuperare tutti i numeri di telefono di un contatto
Il seguente esempio di codice mostra come ottenere tutti i numeri di telefono di un contatto, che equivale a getPhones()
nel servizio Contatti.
Ottenere un numero di telefono specifico per un contatto
Il seguente esempio di codice mostra come ottenere un numero di telefono specifico per un contatto, che equivale a getPhoneNumber()
nel servizio Contatti.