Servizio di gestione delle persone avanzato

dati per gli utenti Google in Apps Script.

Il servizio avanzato People 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.

Questo è 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 saperne di più, consulta Come vengono determinate le firme dei metodi.

Per segnalare problemi e trovare altro supporto, consulta la guida di assistenza per People v1.

Codice campione

Il seguente codice campione utilizza la versione 1 dell'API.

Recuperare le connessioni dell'utente

Per ottenere un elenco delle persone nei contatti dell'utente, utilizza il seguente 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);
  }
}

Recuperare la persona per l'utente

Per recuperare 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);
  }
}

Recuperare la persona per un Account Google

Per recuperare le informazioni personali di 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);
  }
}