People API

ให้ข้อมูลเกี่ยวกับโปรไฟล์และรายชื่อติดต่อ

บริการ: People.googleapis.com

หากต้องการโทรหาบริการนี้ เราขอแนะนําให้คุณใช้ไลบรารีของไคลเอ็นต์จาก Google หากแอปพลิเคชันของคุณต้องใช้ไลบรารีของคุณเองเพื่อเรียกบริการนี้ ให้ใช้ข้อมูลต่อไปนี้เมื่อคุณส่งคําขอ API

เอกสาร Discovery

เอกสารการค้นพบเป็นข้อกําหนดที่เครื่องอ่านได้สําหรับการอธิบายและใช้ REST API ระบบนี้ใช้เพื่อสร้างไลบรารีของไคลเอ็นต์ ปลั๊กอิน IDE และเครื่องมืออื่นๆ ที่โต้ตอบกับ Google API บริการหนึ่งอาจมีเอกสารการค้นพบหลายรายการ บริการนี้มีเอกสารการค้นพบดังต่อไปนี้

ปลายทางบริการ

ปลายทางบริการคือ URL หลักที่ระบุที่อยู่เครือข่ายของบริการ API บริการหนึ่งอาจมีปลายทางบริการหลายแห่ง บริการนี้มีปลายทางบริการต่อไปนี้และ URI ทั้งหมดด้านล่างจะสัมพันธ์กับปลายทางของบริการนี้

  • https://people.googleapis.com

ทรัพยากร REST: v1.contactGroups

วิธีการ
batchGet GET /v1/contactGroups:batchGet
ดูรายชื่อกลุ่มรายชื่อติดต่อของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์โดยระบุรายชื่อชื่อทรัพยากรของกลุ่มรายชื่อติดต่อ
create POST /v1/contactGroups
สร้างกลุ่มรายชื่อติดต่อใหม่ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์
delete DELETE /v1/{resourceName=contactGroups/*}
ลบกลุ่มรายชื่อติดต่อที่มีอยู่ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์โดยการระบุชื่อทรัพยากรกลุ่มรายชื่อติดต่อ
get GET /v1/{resourceName=contactGroups/*}
รับกลุ่มรายชื่อติดต่อเฉพาะที่เป็นของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วโดยการระบุชื่อทรัพยากรกลุ่มรายชื่อติดต่อ
list GET /v1/contactGroups
แสดงรายชื่อกลุ่มรายชื่อติดต่อทั้งหมดที่เป็นของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
อัปเดตชื่อกลุ่มรายชื่อติดต่อที่มีอยู่ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

ทรัพยากร REST: v1.contactGroups.members

วิธีการ
modify POST /v1/{resourceName=contactGroups/*}/members:modify
แก้ไขสมาชิกกลุ่มรายชื่อติดต่อที่เป็นของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

ทรัพยากร REST: v1.otherContacts

วิธีการ
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

คัดลอก "รายชื่อติดต่ออื่น" ไปยังรายชื่อติดต่อใหม่ในกลุ่ม "myContacts" ของผู้ใช้

การส่งคําขออุปสงค์สําหรับผู้ใช้รายเดียวกันควรส่งตามลําดับเพื่อหลีกเลี่ยงเวลาในการตอบสนองและความล้มเหลวที่เพิ่มขึ้น
list GET /v1/otherContacts
แสดงรายชื่อ "รายชื่อติดต่ออื่นๆ" ทั้งหมด ซึ่งเป็นรายชื่อติดต่อที่ไม่ได้อยู่ในกลุ่มรายชื่อติดต่อ
search GET /v1/otherContacts:search
ทํารายการรายชื่อติดต่อในรายชื่อติดต่ออื่นๆ ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคําค้นหา

ทรัพยากร REST: v1.people

วิธีการ
batchCreateContacts POST /v1/people:batchCreateContacts

สร้างกลุ่มรายชื่อติดต่อใหม่และส่งคืน PersonResponses สําหรับข้อมูล

การส่งคําขออุปสงค์สําหรับผู้ใช้รายเดียวกันควรส่งตามลําดับเพื่อหลีกเลี่ยงเวลาในการตอบสนองและความล้มเหลวที่เพิ่มขึ้น
batchDeleteContacts POST /v1/people:batchDeleteContacts
ลบกลุ่มรายชื่อติดต่อ
batchUpdateContacts POST /v1/people:batchUpdateContacts
อัปเดตกลุ่มรายชื่อติดต่อและแสดงผลแผนที่ชื่อทรัพยากรเป็น PersonResponses สําหรับรายชื่อติดต่อที่อัปเดต
createContact POST /v1/people:createContact
สร้างรายชื่อติดต่อใหม่และส่งคืนทรัพยากรบุคคลสําหรับรายชื่อติดต่อนั้น
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
ลบผู้ติดต่อ
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
ลบรูปภาพของรายชื่อติดต่อ
get GET /v1/{resourceName=people/*}
ระบุข้อมูลเกี่ยวกับบุคคลด้วยการระบุชื่อทรัพยากร
getBatchGet GET /v1/people:batchGet
ระบุข้อมูลเกี่ยวกับรายชื่อของบุคคลที่ระบุด้วยการระบุชื่อทรัพยากรที่ขอ
listDirectoryPeople GET /v1/people:listDirectoryPeople
แสดงรายการโปรไฟล์โดเมนและรายชื่อติดต่อของโดเมนในไดเรกทอรีของโดเมนของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
searchContacts GET /v1/people:searchContacts
ทํารายการรายชื่อติดต่อในรายชื่อติดต่อที่จัดกลุ่มไว้ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคําค้นหา
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
จะแสดงรายการโปรไฟล์โดเมนและรายชื่อติดต่อของโดเมนในไดเรกทอรีโดเมนของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคําค้นหา
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
อัปเดตข้อมูลติดต่อของผู้ติดต่อที่มีอยู่
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
อัปเดตรูปภาพของรายชื่อติดต่อ

ทรัพยากร REST: v1.people.connections

วิธีการ
list GET /v1/{resourceName=people/*}/connections
ทํารายการรายชื่อติดต่อของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว