People API

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

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

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

เอกสารการค้นพบ

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

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

ปลายทางของบริการคือ 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
ระบุรายชื่อติดต่อของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว