ให้ข้อมูลเกี่ยวกับรายชื่อบุคคลที่เฉพาะเจาะจงโดยระบุรายการชื่อทรัพยากรที่ขอ ใช้ people/me
เพื่อระบุผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
คำขอจะแสดงข้อผิดพลาด 400 หากไม่ได้ระบุ "personFields"
คำขอ HTTP
GET https://people.googleapis.com/v1/people:batchGet
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
resourceNames[] |
ต้องระบุ ชื่อแหล่งข้อมูลของบุคคลที่จะให้ข้อมูล ทำซ้ำได้ พารามิเตอร์การค้นหาของ URL ควรเป็น
ชื่อทรัพยากรมีได้สูงสุด 200 ชื่อ |
requestMask |
เลิกใช้งานแล้ว (โปรดใช้ มาสก์เพื่อจำกัดผลการค้นหาให้แสดงเฉพาะช่องบุคคลบางส่วน |
personFields |
ต้องระบุ หน้ากากฟิลด์เพื่อจํากัดฟิลด์ในบุคคลแต่ละคนที่จะแสดงผล คุณสามารถระบุหลายช่องโดยคั่นด้วยคอมมา ค่าที่ใช้ได้มีดังนี้
|
sources[] |
ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผล ค่าเริ่มต้นคือ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบกลับคําขอ GET สําหรับรายชื่อบุคคลตามชื่อทรัพยากร
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"responses": [
{
object ( |
ช่อง | |
---|---|
responses[] |
การตอบกลับสำหรับชื่อทรัพยากรที่ขอแต่ละรายการ |
ขอบเขตการให้สิทธิ์
ไม่ต้องมีการให้สิทธิ์เพื่อเข้าถึงข้อมูลสาธารณะ สำหรับข้อมูลส่วนตัว จำเป็นต้องใช้ขอบเขต 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
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์