Google Apps Komut Dosyası hızlı başlangıç kılavuzu

People API'ye istek gönderen bir Google Apps Komut Dosyası oluşturun.

Hızlı başlangıç kılavuzlarında, Google Workspace API'sini çağıran bir uygulamanın nasıl ayarlanacağı ve çalıştırılacağı açıklanmaktadır. Bu hızlı başlangıç kılavuzunda, test ortamı için uygun olan basitleştirilmiş bir kimlik doğrulama yaklaşımı kullanılır. Üretim ortamı için, uygulamanıza uygun erişim kimlik bilgilerini seçmeden önce kimlik doğrulama ve yetkilendirme hakkında bilgi edinmenizi öneririz.

Apps Komut Dosyası'nda, Google Workspace hızlı başlangıçlarında Google Workspace API'lerini çağırmak ve kimlik doğrulama ile yetkilendirme akışının bazı ayrıntılarını işlemek için gelişmiş Google hizmetleri kullanılır.

Hedefler

  • Ortamı yapılandırın.
  • Komut dosyasını oluşturun ve yapılandırın.
  • Komut dosyasını çalıştırın.

Ön koşullar

  • Google Drive'a erişim

Komut dosyasını oluşturma

  1. script.google.com/create adresine giderek Apps Komut Dosyası düzenleyicisinde yeni bir komut dosyası oluşturun.
  2. Komut dosyası düzenleyicinin içeriğini aşağıdaki kodla değiştirin:

people/quickstart/quickstart.gs
/**
 * @typedef {Object} EmailAddress
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} value
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Name
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} displayName
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Person
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {Name[]} names
 * @property {EmailAddress[]} [emailAddresses]
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Connection
 * @see https://developers.google.com/people/api/rest/v1/people.connections/list
 * @property {Person[]} connections
 * Note: This is a partial definition.
 */

/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  // Use the People API to list the connections of the logged in user.
  // See: https://developers.google.com/people/api/rest/v1/people.connections/list
  if (!People || !People.People || !People.People.Connections) {
    throw new Error("People service not enabled.");
  }
  const connections = People.People.Connections.list("people/me", {
    pageSize: 10,
    personFields: "names,emailAddresses",
  });
  if (!connections.connections) {
    console.log("No connections found.");
    return;
  }
  for (const person of connections.connections) {
    if (
      person.names &&
      person.names.length > 0 &&
      person.names[0].displayName
    ) {
      console.log(person.names[0].displayName);
    } else {
      console.log("No display name found for connection.");
    }
  }
}

  1. Kaydet'i tıklayın.
  2. Adsız proje'yi tıklayın, Hızlı Başlangıç yazın ve Yeniden adlandır'ı tıklayın.

Komut dosyasını yapılandırma

People API'yi etkinleştirme

Apps Komut Dosyası projesini açın.

  1. Düzenleyen'i tıklayın.
  2. Hizmetler'in yanında Hizmet ekle'yi tıklayın .
  3. People API'yi seçip Ekle'yi tıklayın.

Örneği çalıştırma

Apps Komut Dosyası Düzenleyicisi'nde Çalıştır'ı tıklayın.

Örneği ilk kez çalıştırdığınızda erişimi yetkilendirmeniz istenir:

  1. İzinleri incele'yi tıklayın.
  2. Bir hesap seçin.
  3. İzin ver'i tıklayın.

Komut dosyasının yürütme günlüğü pencerenin alt kısmında görünür.

Sonraki adımlar