Servizio di gestione delle persone avanzato

dati per gli utenti Google in Apps Script.

Il servizio avanzato Persone ti consente di utilizzare l'API People in Google Apps Script. Questa API consente agli script di creare, leggere e aggiornare i dati di contatto dell'utente che ha eseguito l'accesso e di leggere i dati del profilo degli utenti Google.

Si tratta di un servizio avanzato che deve essere abilitato prima dell'uso.

Riferimento

Per informazioni dettagliate su questo servizio, consulta la documentazione di riferimento dell'API People. Come tutti i servizi avanzati in Apps Script, il servizio avanzato People utilizza gli stessi oggetti, metodi e parametri dell'API pubblica. Per maggiori informazioni, consulta Come vengono determinate le firme dei metodi.

Per segnalare problemi e trovare altro supporto, consulta la Guida all'assistenza per Persone v1.

Codice di esempio

Il seguente codice di esempio utilizza la versione 1 dell'API.

Recuperare le connessioni dell'utente

Per ottenere un elenco di persone nei contatti dell'utente, utilizza questo codice:

advanced/people.gs
/**
 * Gets a list of people in the user's contacts.
 * @see https://developers.google.com/people/api/rest/v1/people.connections/list
 */
function getConnections() {
  try {
    // Get the list of connections/contacts of user's profile
    const people = People.People.Connections.list("people/me", {
      personFields: "names,emailAddresses",
    });
    // Print the connections/contacts
    console.log("Connections: %s", JSON.stringify(people, null, 2));
  } catch (err) {
    // TODO (developers) - Handle exception here
    console.log("Failed to get the connection with an error %s", err.message);
  }
}

Recupera la persona per l'utente

Per ottenere il profilo dell'utente, devi richiedere l'ambito https://www.googleapis.com/auth/userinfo.profile seguendo le istruzioni per aggiungere ambiti espliciti al file manifest appsscript.json. Una volta aggiunto l'ambito, puoi utilizzare il seguente codice:

advanced/people.gs
/**
 * Gets the own user's profile.
 * @see https://developers.google.com/people/api/rest/v1/people/getBatchGet
 */
function getSelf() {
  try {
    // Get own user's profile using People.getBatchGet() method
    const people = People.People.getBatchGet({
      resourceNames: ["people/me"],
      personFields: "names,emailAddresses",
      // Use other query parameter here if needed
    });
    console.log("Myself: %s", JSON.stringify(people, null, 2));
  } catch (err) {
    // TODO (developer) -Handle exception
    console.log("Failed to get own profile with an error %s", err.message);
  }
}

Ottenere i dati della persona per un Account Google

Per ottenere le informazioni personali per qualsiasi Account Google, utilizza il seguente codice:

advanced/people.gs
/**
 * Gets the person information for any Google Account.
 * @param {string} accountId The account ID.
 * @see https://developers.google.com/people/api/rest/v1/people/get
 */
function getAccount(accountId) {
  try {
    // Get the Account details using account ID.
    const people = People.People.get(`people/${accountId}`, {
      personFields: "names,emailAddresses",
    });
    // Print the profile details of Account.
    console.log("Public Profile: %s", JSON.stringify(people, null, 2));
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log("Failed to get account with an error %s", err.message);
  }
}