Erweiterter Personendienst

Mit dem erweiterten People-Dienst können Sie die People API in Apps Script verwenden. Mit dieser API können Skripts Kontaktdaten für den angemeldeten Nutzer erstellen, lesen und aktualisieren sowie Profildaten für Google-Nutzer lesen.

Referenz

Weitere Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur People API. Wie alle erweiterten Dienste in Apps Script verwendet der erweiterte People-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Methodensignaturen ermitteln.

Informationen zum Melden von Problemen und zu Supportoptionen finden Sie im People v1-Supportleitfaden.

Beispielcode

Im folgenden Beispielcode wird Version 1 der API verwendet.

Verbindungen des Nutzers abrufen

Verwenden Sie den folgenden Code, um eine Liste der Personen in den Kontakten des Nutzers abzurufen:

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

Person für den Nutzer abrufen

Wenn Sie das Profil des Nutzers abrufen möchten, müssen Sie den Bereich https://www.googleapis.com/auth/userinfo.profile anfordern. Folgen Sie dazu der Anleitung zum Hinzufügen expliziter Bereiche zu Ihrer appsscript.json-Manifestdatei. Nachdem der Bereich hinzugefügt wurde, können Sie den folgenden Code verwenden:

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

Person für ein Google-Konto abrufen

Um die Personeninformationen für ein beliebiges Google-Konto abzurufen, verwenden Sie den folgenden Code:

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