บริการบุคคลขั้นสูง

ข้อมูลสำหรับผู้ใช้ Google ใน Apps Script

Advanced People Service ช่วยให้คุณใช้ People API ใน Google Apps Script ได้ API นี้ช่วยให้สคริปต์สร้าง อ่าน และอัปเดต ข้อมูลรายชื่อติดต่อสำหรับผู้ใช้ที่เข้าสู่ระบบ และอ่านข้อมูลโปรไฟล์สำหรับผู้ใช้ Google ได้

นี่เป็นบริการขั้นสูงที่ต้องเปิดใช้ก่อนใช้งาน

ข้อมูลอ้างอิง

ดูข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ได้ที่เอกสารอ้างอิงสำหรับ People API เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script บริการขั้นสูงของ People จะใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ ดูข้อมูลเพิ่มเติมได้ที่ วิธีกำหนดลายเซ็นของเมธอด

หากต้องการรายงานปัญหาและรับการสนับสนุนอื่นๆ โปรดดู คู่มือการสนับสนุน People API v1

โค้ดตัวอย่าง

โค้ดตัวอย่างต่อไปนี้ใช้ API เวอร์ชัน 1

รับการเชื่อมต่อของผู้ใช้

หากต้องการดูรายชื่อบุคคลในรายชื่อติดต่อของผู้ใช้ ให้ใช้โค้ดต่อไปนี้

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

รับบุคคลสำหรับผู้ใช้

หากต้องการรับโปรไฟล์ของผู้ใช้ คุณต้องขอขอบเขต https://www.googleapis.com/auth/userinfo.profile โดยทำตามวิธีการเพิ่มขอบเขตที่ชัดเจน ลงในไฟล์ Manifest ของ appsscript.json เมื่อเพิ่มขอบเขตแล้ว คุณจะใช้โค้ดต่อไปนี้ได้

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

รับบุคคลสำหรับบัญชี Google

หากต้องการรับข้อมูลบุคคลสำหรับบัญชี Google ใดก็ตาม ให้ใช้โค้ดต่อไปนี้

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