Method: people.getBatchGet

ให้ข้อมูลเกี่ยวกับรายชื่อบุคคลที่เฉพาะเจาะจงโดยระบุรายการชื่อทรัพยากรที่ขอ ใช้ people/me เพื่อระบุผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

คำขอจะแสดงข้อผิดพลาด 400 หากไม่ได้ระบุ "personFields"

คำขอ HTTP

GET https://people.googleapis.com/v1/people:batchGet

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
resourceNames[]

string

ต้องระบุ ชื่อแหล่งข้อมูลของบุคคลที่จะให้ข้อมูล ทำซ้ำได้ พารามิเตอร์การค้นหาของ URL ควรเป็น

resourceNames=<name1>&resourceNames=<name2>&...

  • หากต้องการดูข้อมูลเกี่ยวกับผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ให้ระบุ people/me
  • หากต้องการดูข้อมูลเกี่ยวกับบัญชี Google ให้ระบุ people/{account_id}
  • หากต้องการทราบข้อมูลเกี่ยวกับรายชื่อติดต่อ ให้ระบุชื่อทรัพยากรที่ระบุรายชื่อติดต่อตามที่ people.connections.list แสดง

ชื่อทรัพยากรมีได้สูงสุด 200 ชื่อ
requestMask
(deprecated)

object (RequestMask)

เลิกใช้งานแล้ว (โปรดใช้ personFields แทน)

มาสก์เพื่อจำกัดผลการค้นหาให้แสดงเฉพาะช่องบุคคลบางส่วน
personFields

string (FieldMask format)

ต้องระบุ หน้ากากฟิลด์เพื่อจํากัดฟิลด์ในบุคคลแต่ละคนที่จะแสดงผล คุณสามารถระบุหลายช่องโดยคั่นด้วยคอมมา ค่าที่ใช้ได้มีดังนี้

  • ที่อยู่
  • ageRanges
  • ชีวประวัติ
  • วันเกิด
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • กิจกรรม
  • externalIds
  • เพศ
  • imClients
  • ความสนใจ
  • ภาษา
  • สถานที่ตั้ง
  • ของช่อง
  • ข้อมูลเมตา
  • miscKeywords
  • ชื่อ
  • ชื่อเล่น
  • อาชีพ
  • องค์กร
  • phoneNumbers
  • รูปภาพ
  • ความสัมพันธ์
  • sipAddresses
  • ทักษะ
  • URL
  • userDefined
sources[]

enum (ReadSourceType)

ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผล ค่าเริ่มต้นคือ READ_SOURCE_TYPE_CONTACT และ READ_SOURCE_TYPE_PROFILE หากไม่ได้ตั้งค่าไว้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับคําขอ GET สําหรับรายชื่อบุคคลตามชื่อทรัพยากร

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
ช่อง
responses[]

object (PersonResponse)

การตอบกลับสำหรับชื่อทรัพยากรที่ขอแต่ละรายการ

ขอบเขตการให้สิทธิ์

ไม่ต้องมีการให้สิทธิ์เพื่อเข้าถึงข้อมูลสาธารณะ สำหรับข้อมูลส่วนตัว จำเป็นต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile
  • https://www.googleapis.com/auth/profile.language.read

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์