- แหล่งข้อมูล: บุคคล
- การแสดง JSON
- PersonMetadata
- แหล่งที่มา
- ประเภทแหล่งข้อมูล
- โปรไฟล์ข้อมูลเมตา
- ประเภทออบเจ็กต์
- ประเภทผู้ใช้
- ที่อยู่
- ฟิลด์ข้อมูลเมตา
- ช่วงอายุ
- ประเภทช่วงอายุ
- ชีวประวัติ
- ประเภทเนื้อหา
- วันเกิด
- วันที่
- BraggingRights
- Url ของปฏิทิน
- ClientData
- รูปภาพปก
- EmailAddress
- เหตุการณ์
- รหัสภายนอก
- FileA
- เพศ
- ระบบไคลเอ็นต์
- ความสนใจ
- ภาษา
- ตําแหน่ง
- การเป็นสมาชิก
- ข้อมูลติดต่อกลุ่ม
- การเป็นสมาชิกโดเมน
- MiscKeyword
- ประเภทคีย์เวิร์ด
- ชื่อ
- ชื่อเล่น
- ประเภทชื่อเล่น
- อาชีพ
- องค์กร
- หมายเลขโทรศัพท์
- รูปภาพ
- ความสัมพันธ์
- ความสนใจในความสัมพันธ์
- สถานะความสัมพันธ์
- ที่พักอาศัย
- SipAddress
- ทักษะ
- แท็กไลน์
- URL
- กําหนดโดยผู้ใช้
- เมธอด
แหล่งข้อมูล: บุคคล
ข้อมูลเกี่ยวกับบุคคลที่ผสานรวมจากแหล่งข้อมูลที่หลากหลาย เช่น รายชื่อติดต่อและข้อมูลโปรไฟล์ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
ช่องส่วนใหญ่มีหลายรายการได้ รายการในช่องไม่มีคําสั่งซื้อที่รับประกันการแสดงผล แต่รับประกันว่าช่องที่ไม่ว่างเปล่าแต่ละช่องจะมีช่องเดียวที่กําหนด metadata.primary
เป็น "จริง"
การแสดง JSON |
---|
{ "resourceName": string, "etag": string, "metadata": { object ( |
ช่อง | |
---|---|
resourceName |
ชื่อทรัพยากรของบุคคล ที่เซิร์ฟเวอร์กําหนด สตริง ASCII ในรูปแบบ |
etag |
แท็กเอนทิตี HTTP ของทรัพยากร ใช้สําหรับการตรวจสอบแคชบนเว็บ |
metadata |
เอาต์พุตเท่านั้น ข้อมูลเมตาเกี่ยวกับบุคคลนั้น |
addresses[] |
ที่อยู่ของบุคคล |
ageRange |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว (โปรดใช้ ช่วงอายุของผู้ใช้ |
ageRanges[] |
เอาต์พุตเท่านั้น ช่วงอายุของบุคคล |
biographies[] |
ชีวประวัติบุคคล ช่องนี้เป็นช่องทางเดียวสําหรับแหล่งที่มาของรายชื่อติดต่อ |
birthdays[] |
วันเกิดของบุคคลดังกล่าว ช่องนี้เป็นช่องทางเดียวสําหรับแหล่งที่มาของรายชื่อติดต่อ |
braggingRights[] |
เลิกใช้งานแล้ว: ระบบจะไม่ส่งข้อมูลให้สิทธิ์ในการโม้ของบุคคลดังกล่าว |
calendarUrls[] |
URL ของปฏิทินของบุคคลนั้น |
clientData[] |
ข้อมูลไคลเอ็นต์ของบุคคลนั้น |
coverPhotos[] |
เอาต์พุตเท่านั้น รูปภาพปกของบุคคลดังกล่าว |
emailAddresses[] |
อีเมลของบุคคลนั้น สําหรับ |
events[] |
เหตุการณ์ของบุคคลนั้น |
externalIds[] |
รหัสภายนอกของบุคคลนั้น |
fileAses[] |
ไฟล์ที่ผู้ใช้เป็นเจ้าของ |
genders[] |
เพศของบุคคล ช่องนี้เป็นช่องทางเดียวสําหรับแหล่งที่มาของรายชื่อติดต่อ |
imClients[] |
ไคลเอ็นต์การรับส่งข้อความโต้ตอบแบบทันทีของบุคคล |
interests[] |
ความสนใจของบุคคล |
locales[] |
ค่ากําหนดภาษาของบุคคล |
locations[] |
ตําแหน่งที่อยู่ของผู้ใช้ |
memberships[] |
การเป็นสมาชิกกลุ่มของบุคคล |
miscKeywords[] |
คีย์เวิร์ดเบ็ดเตล็ดของบุคคลดังกล่าว |
names[] |
ชื่อของบุคคลนั้น ช่องนี้เป็นช่องทางเดียวสําหรับแหล่งที่มาของรายชื่อติดต่อ |
nicknames[] |
ชื่อเล่นของบุคคลดังกล่าว |
occupations[] |
อาชีพของบุคคลดังกล่าว |
organizations[] |
องค์กรที่ผ่านมาหรือบุคคลปัจจุบัน |
phoneNumbers[] |
หมายเลขโทรศัพท์ของบุคคลนั้น สําหรับ |
photos[] |
เอาต์พุตเท่านั้น รูปภาพของบุคคลนั้น |
relations[] |
ความสัมพันธ์ของบุคคลดังกล่าว |
relationshipInterests[] |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: จะไม่มีการส่งคืนข้อมูลความสัมพันธ์ของบุคคลดังกล่าว |
relationshipStatuses[] |
เอาต์พุตเท่านั้น เลิกใช้งาน: ไม่มีข้อมูลที่จะแสดง สถานะความสัมพันธ์ของบุคคลนั้น |
residences[] |
เลิกใช้งานแล้ว: (โปรดใช้ |
sipAddresses[] |
ที่อยู่ SIP ของบุคคล |
skills[] |
ทักษะของบุคคลดังกล่าว |
taglines[] |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ระบบจะไม่ส่งข้อมูลแท็กไลน์ของบุคคลนั้น |
urls[] |
URL ที่เชื่อมโยงของบุคคล |
userDefined[] |
ข้อมูลที่ผู้ใช้กําหนดไว้ของผู้ใช้ |
ข้อมูลเมตาของบุคคล
ข้อมูลเมตาเกี่ยวกับบุคคล
การแสดง JSON |
---|
{ "sources": [ { object ( |
ช่อง | |
---|---|
sources[] |
แหล่งข้อมูลของบุคคล |
previousResourceNames[] |
เอาต์พุตเท่านั้น ชื่อทรัพยากรเดิมที่บุคคลนี้มี ป้อนข้อมูลสําหรับคําขอ ชื่อทรัพยากรอาจเปลี่ยนแปลงเมื่อเพิ่มหรือนําช่องที่ลิงก์รายชื่อติดต่อและโปรไฟล์ออก เช่น อีเมลที่ได้รับการยืนยัน หมายเลขโทรศัพท์ที่ยืนยันแล้ว หรือ URL ของโปรไฟล์ |
linkedPeopleResourceNames[] |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของบุคคลที่ลิงก์กับทรัพยากรนี้ |
deleted |
เอาต์พุตเท่านั้น จริงหากลบทรัพยากรบุคคลแล้ว ป้อนข้อมูลสําหรับคําขอซิงค์ |
objectType |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว (โปรดใช้ ประเภทของออบเจ็กต์บุคคล |
แหล่งที่มา
แหล่งที่มาของช่อง
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของแหล่งข้อมูล |
id |
ตัวระบุที่ไม่ซ้ํากันภายในประเภทแหล่งที่มาที่เซิร์ฟเวอร์สร้างขึ้น |
etag |
ป้อนข้อมูลใน แท็กเอนทิตี HTTP ของแหล่งที่มา ใช้สําหรับการตรวจสอบแคชบนเว็บ |
updateTime |
เอาต์พุตเท่านั้น ป้อนข้อมูลใน การประทับเวลาการอัปเดตครั้งล่าสุดของแหล่งที่มานี้ การประทับเวลาในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดระดับนาโนวินาทีและเป็นตัวเลขเศษส่วนไม่เกิน 9 หลัก ตัวอย่าง: |
profileMetadata |
เอาต์พุตเท่านั้น ป้อนข้อมูลใน ข้อมูลเมตาเกี่ยวกับแหล่งที่มาของประเภท PROFILE |
ประเภทแหล่งที่มา
ประเภทของแหล่งข้อมูล
Enum | |
---|---|
SOURCE_TYPE_UNSPECIFIED |
ไม่ระบุ |
ACCOUNT |
บัญชี Google |
PROFILE |
โปรไฟล์ Google คุณดูโปรไฟล์ได้ที่ https://profile.google.com/{id} โดยที่ {id} คือรหัสแหล่งที่มา |
DOMAIN_PROFILE |
โปรไฟล์โดเมน Google Workspace |
CONTACT |
รายชื่อติดต่อ Google คุณสามารถดูรายชื่อติดต่อได้ที่ https://contact.google.com/{id} โดยที่ {id} คือรหัสแหล่งที่มา |
OTHER_CONTACT |
Google "รายชื่อติดต่ออื่นๆ" |
DOMAIN_CONTACT |
รายชื่อติดต่อที่แชร์ของโดเมน Google Workspace |
ข้อมูลเมตาโปรไฟล์
ข้อมูลเมตาเกี่ยวกับโปรไฟล์
การแสดง JSON |
---|
{ "objectType": enum ( |
ช่อง | |
---|---|
objectType |
เอาต์พุตเท่านั้น ประเภทออบเจ็กต์ของโปรไฟล์ |
userTypes[] |
เอาต์พุตเท่านั้น ประเภทของผู้ใช้ |
ประเภทออบเจ็กต์
ประเภทของออบเจ็กต์บุคคล
Enum | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
ไม่ระบุ |
PERSON |
บุคคล |
PAGE |
หน้า Currents |
ประเภทผู้ใช้
ประเภทของผู้ใช้
Enum | |
---|---|
USER_TYPE_UNKNOWN |
ระบบไม่รู้จักผู้ใช้ประเภทนี้ |
GOOGLE_USER |
ผู้ใช้เป็นผู้ใช้ Google |
GPLUS_USER |
ผู้ใช้เป็นผู้ใช้ Currents |
GOOGLE_APPS_USER |
ผู้ใช้เป็นผู้ใช้ Google Workspace |
ที่อยู่
ที่อยู่จริงของผู้ใช้ อาจเป็นตู้ ปณ. หรือที่อยู่ ช่องทั้งหมดจะมีหรือไม่มีก็ได้
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับที่อยู่ |
formattedValue |
ค่าที่ไม่มีโครงสร้างของที่อยู่ หากไม่ได้ตั้งค่าโดยผู้ใช้ ระบบจะสร้างโปรไฟล์โดยอัตโนมัติจากค่าที่มีโครงสร้าง |
type |
ประเภทของที่อยู่ ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของที่อยู่ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
poBox |
ตู้ ปณ. ของที่อยู่ |
streetAddress |
ที่อยู่ |
extendedAddress |
ที่อยู่แบบขยายของที่อยู่ เช่น หมายเลขอพาร์ตเมนต์ |
city |
เมืองของที่อยู่ |
region |
ภูมิภาคของที่อยู่ เช่น รัฐหรือจังหวัด |
postalCode |
รหัสไปรษณีย์ของที่อยู่ |
country |
ประเทศของที่อยู่ |
countryCode |
รหัสประเทศของ ISO 3166-1 alpha-2 ของที่อยู่ |
ข้อมูลเมตาของช่อง
ข้อมูลเมตาเกี่ยวกับช่อง
การแสดง JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
ช่อง | |
---|---|
primary |
เอาต์พุตเท่านั้น เป็นจริงหากช่องนี้เป็นช่องหลักสําหรับแหล่งที่มาทั้งหมดในบุคคล แต่ละคนจะมีช่องได้ไม่เกิน 1 ช่องซึ่งตั้งค่าเป็น |
sourcePrimary |
เป็นจริงหากช่องนี้เป็นช่องหลักของ |
verified |
เอาต์พุตเท่านั้น เป็นจริงหากช่องได้รับการยืนยัน เป็นเท็จ หากช่องไม่ได้รับการยืนยัน โดยปกติ ช่องที่ยืนยันแล้วคือชื่อ อีเมล หมายเลขโทรศัพท์ หรือเว็บไซต์ที่ยืนยันแล้วว่าบุคคลดังกล่าวเป็นเจ้าของ |
source |
แหล่งที่มาของช่อง |
ช่วงอายุ
เลิกใช้งานแล้ว (โปรดใช้ person.ageRanges
แทน)
ช่วงอายุของบุคคล
Enum | |
---|---|
AGE_RANGE_UNSPECIFIED |
ไม่ระบุ |
LESS_THAN_EIGHTEEN |
อายุต่ํากว่า 18 ปี |
EIGHTEEN_TO_TWENTY |
ระหว่าง 18 ถึง 20 |
TWENTY_ONE_OR_OLDER |
21 ขึ้นไป |
ประเภทช่วงอายุ
ช่วงอายุของบุคคล
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับช่วงอายุ |
ageRange |
ช่วงอายุ |
ชีวประวัติ
ชีวประวัติสั้นๆ ของบุคคล
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับชีวประวัติ |
value |
ชีวประวัติสั้นๆ |
contentType |
ประเภทเนื้อหาของชีวประวัติ |
ประเภทเนื้อหา
ประเภทของเนื้อหา
Enum | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
ไม่ระบุ |
TEXT_PLAIN |
ข้อความธรรมดา |
TEXT_HTML |
ข้อความ HTML |
วันเกิด
วันเกิดของบุคคล ระบุช่อง date
และ text
อย่างน้อย 1 ช่อง โดยทั่วไปช่อง date
และ text
จะแสดงวันที่เดียวกัน แต่ไม่รับประกันว่าจะได้มา ลูกค้าควรตั้งค่าช่อง date
เมื่อปิดเสียงวันเกิดเสมอ
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับวันเกิด |
date |
วันที่ที่เกิดวันเกิด |
text |
ต้องการใช้ช่อง สตริงรูปแบบอิสระที่แสดงถึงวันเกิดของผู้ใช้ ค่านี้ไม่ได้รับการตรวจสอบ |
วันที่
แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลาจะระบุไว้ที่อื่นหรือไม่มีนัยสําคัญ วันที่นี้สัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
- วันที่แบบเต็ม พร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
- 1 เดือนและ 1 ปี โดย 0 ปี (เช่น วันครบรอบ)
- 1 ปีโดยไม่รวม 0 เดือนและ 0 วัน
- ปีและเดือนซึ่งมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)
ประเภทที่เกี่ยวข้องมีดังนี้
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
การแสดง JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
ช่อง | |
---|---|
year |
ปีของวันที่ ต้องมีค่าตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี |
month |
เดือนในรอบปี ต้องมีค่าระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีที่ไม่มีเดือนและวัน |
day |
วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีที่กําหนดเองหรือปีและเดือนที่ไม่สําคัญ |
สิทธิ์ในการโม้
เลิกใช้งานแล้ว: ระบบจะไม่ส่งข้อมูลสิทธิในการโม้ของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับสิทธิ์ในการโม้ |
value |
สิทธิ์ในการโม้ เช่น |
URL ของปฏิทิน
URL ปฏิทินของผู้ใช้
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับ URL ของปฏิทิน |
url |
URL ของปฏิทิน |
type |
ประเภทของ URL ปฏิทิน ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของ URL ปฏิทินที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
ข้อมูลลูกค้า
ข้อมูลของลูกค้าที่กําหนดเอง อนุญาตให้ใช้คีย์และค่าซ้ํากัน
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับข้อมูลไคลเอ็นต์ |
key |
คีย์ที่ระบุของไคลเอ็นต์ของข้อมูลไคลเอ็นต์ |
value |
ค่าที่ลูกค้าระบุของข้อมูลลูกค้า |
รูปภาพปก
รูปภาพปกของบุคคล รูปภาพขนาดใหญ่ที่แสดงในหน้าโปรไฟล์ของผู้ใช้ซึ่งแสดงถึงตัวตนหรือสิ่งที่พวกเขาสนใจ
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับรูปภาพปก |
url |
URL ของรูปภาพปก |
default |
เป็นจริงหากรูปภาพปกนั้นเป็นรูปภาพปกเริ่มต้น เป็นเท็จ หากรูปภาพปกเป็นรูปภาพปกที่ผู้ใช้ให้ไว้ |
EmailAddress
อีเมลของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับอีเมล |
value |
อีเมล |
type |
ประเภทของอีเมล ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของอีเมลที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
displayName |
ชื่อที่แสดงของอีเมล |
เหตุการณ์
เหตุการณ์ที่เกี่ยวข้องกับบุคคลดังกล่าว
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับเหตุการณ์ |
date |
วันที่เกิดเหตุการณ์ |
type |
ประเภทของเหตุการณ์ ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของเหตุการณ์ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
Externalid
ตัวระบุจากบุคคลภายนอกที่เกี่ยวข้องกับบุคคลดังกล่าว
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับรหัสภายนอก |
value |
ค่าของรหัสภายนอก |
type |
ประเภทของรหัสภายนอก ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของเหตุการณ์ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
FileA
ชื่อที่ควรใช้ในการจัดเรียงบุคคลในรายชื่อ
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับไฟล์ |
value |
ค่าไฟล์ในฐานะ |
เพศ
เพศของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับเพศ |
value |
เพศของบุคคล คุณจะเลือกระบุเพศหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้ก็ได้
|
formattedValue |
เอาต์พุตเท่านั้น ค่าของเพศที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
addressMeAs |
ช่องข้อความรูปแบบอิสระสําหรับคําสรรพนามซึ่งควรใช้ในการตอบคําถามของบุคคลดังกล่าว ค่าทั่วไป ได้แก่
|
ไคลเอ็นต์
ไคลเอ็นต์การรับส่งข้อความโต้ตอบแบบทันทีของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับไคลเอ็นต์ IM |
username |
ชื่อผู้ใช้ที่ใช้ในไคลเอ็นต์ IM |
type |
ประเภทของไคลเอ็นต์ IM ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของไคลเอ็นต์ IM ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
protocol |
โปรโตคอลของไคลเอ็นต์ IM โดยจะเป็นโปรโตคอลที่กําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าอย่างใดอย่างหนึ่งต่อไปนี้ก็ได้
|
formattedProtocol |
เอาต์พุตเท่านั้น โปรโตคอลของไคลเอ็นต์ IM ซึ่งจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
ดอกเบี้ย
ความสนใจอย่างหนึ่งของผู้ใช้
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับความสนใจ |
value |
ความสนใจ เช่น |
ภาษา
ค่ากําหนดภาษาของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับภาษา |
value |
แท็กภาษา IETF BCP 47 ที่มีรูปแบบที่ดีแสดงถึงภาษา |
ตำแหน่ง
ตําแหน่งของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับสถานที่ตั้ง |
value |
ค่ารูปแบบอิสระของสถานที่ตั้ง |
type |
ประเภทของสถานที่ ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
current |
ตําแหน่งเป็นตําแหน่งปัจจุบันหรือไม่ |
buildingId |
ตัวระบุอาคาร |
floor |
ชื่อหรือชั้น |
floorSection |
ส่วนชั้นใน |
deskCode |
สถานที่ตั้งของโต๊ะทํางาน |
การเป็นสมาชิก
การเป็นสมาชิกของบุคคลในกลุ่ม แก้ไขได้เฉพาะการเป็นสมาชิกกลุ่มในรายชื่อติดต่อ
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับการเป็นสมาชิก |
ช่อง Union membership การเป็นสมาชิก membership ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้ |
|
contactGroupMembership |
การเป็นสมาชิกของกลุ่มรายชื่อติดต่อ |
domainMembership |
เอาต์พุตเท่านั้น การเป็นสมาชิกโดเมน |
ข้อมูลติดต่อกลุ่ม
การเป็นสมาชิกกลุ่มรายชื่อติดต่อของ Google
การแสดง JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
ช่อง | |
---|---|
contactGroupId |
เอาต์พุตเท่านั้น รหัสกลุ่มรายชื่อติดต่อของการเป็นสมาชิกกลุ่มรายชื่อติดต่อ |
contactGroupResourceName |
ชื่อทรัพยากรสําหรับกลุ่มรายชื่อติดต่อที่เซิร์ฟเวอร์กําหนด สตริง ASCII ในรูปแบบ |
การเป็นสมาชิกโดเมน
การเป็นสมาชิกโดเมน Google Workspace
การแสดง JSON |
---|
{ "inViewerDomain": boolean } |
ช่อง | |
---|---|
inViewerDomain |
เป็นจริงหากบุคคลนั้นอยู่ในโดเมน Google Workspace ของผู้ชม |
คีย์เวิร์ดอื่นๆ
คีย์เวิร์ดเบ็ดเตล็ดของบุคคล
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับคีย์เวิร์ดเบ็ดเตล็ด |
value |
ค่าของคีย์เวิร์ดเบ็ดเตล็ด |
type |
ประเภทคีย์เวิร์ดเบ็ดเตล็ด |
formattedType |
เอาต์พุตเท่านั้น ประเภทคีย์เวิร์ดเบ็ดเตล็ดที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
ประเภทคีย์เวิร์ด
ประเภทของคีย์เวิร์ดเบ็ดเตล็ด
Enum | |
---|---|
TYPE_UNSPECIFIED |
ไม่ระบุ |
OUTLOOK_BILLING_INFORMATION |
ช่อง Outlook สําหรับข้อมูลสําหรับการเรียกเก็บเงิน |
OUTLOOK_DIRECTORY_SERVER |
ช่อง Outlook สําหรับเซิร์ฟเวอร์ไดเรกทอรี |
OUTLOOK_KEYWORD |
ช่อง Outlook สําหรับคีย์เวิร์ด |
OUTLOOK_MILEAGE |
ช่อง Outlook สําหรับระยะทาง |
OUTLOOK_PRIORITY |
ช่อง Outlook สําหรับลําดับความสําคัญ |
OUTLOOK_SENSITIVITY |
ช่อง Outlook สําหรับความละเอียดอ่อน |
OUTLOOK_SUBJECT |
ช่อง Outlook สําหรับหัวเรื่อง |
OUTLOOK_USER |
ช่อง Outlook สําหรับผู้ใช้ |
HOME |
บ้าน |
WORK |
งาน |
OTHER |
อื่นๆ |
ชื่อ
ชื่อบุคคล หากชื่อเป็นชื่อเดียว ชื่อครอบครัวจะว่างเปล่า
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับชื่อ |
displayName |
เอาต์พุตเท่านั้น ชื่อที่แสดงที่จัดรูปแบบตามภาษาที่กําหนดโดยบัญชีของผู้ดูหรือส่วนหัว HTTP ของ |
displayNameLastFirst |
เอาต์พุตเท่านั้น ชื่อที่แสดงที่มีนามสกุลจะจัดรูปแบบครั้งแรกตามภาษาที่กําหนดโดยบัญชีของผู้ชมหรือส่วนหัว HTTP ของ |
unstructuredName |
ค่าชื่อรูปแบบอิสระ |
familyName |
นามสกุล |
givenName |
ชื่อที่ระบุ |
middleName |
ชื่อกลาง |
honorificPrefix |
คํานําหน้านําหน้าอย่างเช่น |
honorificSuffix |
คําต่อท้ายที่เชื่อถือได้ เช่น |
phoneticFullName |
ชื่อและนามสกุลสะกดเมื่อพูด |
phoneticFamilyName |
นามสกุลครอบครัวสะกดขณะที่พูด |
phoneticGivenName |
ชื่อที่ระบุสะกดขณะที่พูด |
phoneticMiddleName |
ชื่อกลางจะสะกดขณะที่พูด |
phoneticHonorificPrefix |
คํานําหน้าที่สะกดเมื่อสะกดเป็นเสียงเดียวกัน |
phoneticHonorificSuffix |
คําต่อท้ายอันงดงาม |
ชื่อเล่น
ชื่อเล่นของบุคคล
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับชื่อเล่น |
value |
ชื่อเล่น |
type |
ประเภทของชื่อเล่น |
ประเภทชื่อเล่น
ประเภทของชื่อเล่น
Enum | |
---|---|
DEFAULT |
ชื่อเล่นทั่วไป |
MAIDEN_NAME |
นามสกุลเดิมหรือนามสกุล ใช้เมื่อครอบครัวของบุคคลดังกล่าวเปลี่ยนไปจากการแต่งงาน |
INITIALS |
ชื่อย่อ |
GPLUS |
ชื่อเล่นของโปรไฟล์ Google+ |
OTHER_NAME |
แอฟฟิลิเอตหรือชื่ออื่นๆ เช่น |
ALTERNATE_NAME |
ชื่ออื่นที่ผู้คนรู้จัก |
SHORT_NAME |
ชื่อบุคคลเวอร์ชันย่อ |
อาชีพ
อาชีพของบุคคลหนึ่ง
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับอาชีพ |
value |
อาชีพ เช่น |
องค์กร
องค์กรในอดีตหรือปัจจุบันของบุคคล อนุญาตให้ใช้ช่วงวันที่ที่ทับซ้อนกัน
การแสดง JSON |
---|
{ "metadata": { object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับองค์กร |
type |
ประเภทองค์กร ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทองค์กรที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
startDate |
วันที่เริ่มต้นที่บุคคลดังกล่าวเข้าร่วมองค์กร |
endDate |
วันที่สิ้นสุดเมื่อบุคคลดังกล่าวออกจากองค์กรแล้ว |
current |
เป็นจริงหากองค์กรเป็นองค์กรปัจจุบันของบุคคล เท็จหากองค์กรเป็นองค์กรที่ผ่านมา |
name |
ชื่อขององค์กร |
phoneticName |
ชื่อการออกเสียงขององค์กร |
department |
แผนกของบุคคลในองค์กร |
title |
ตําแหน่งงานของผู้ใช้ในองค์กร |
jobDescription |
รายละเอียดงานของบุคคลนั้นในองค์กร |
symbol |
สัญลักษณ์ที่เชื่อมโยงกับองค์กร เช่น สัญลักษณ์หุ้น ตัวย่อ หรือตัวย่อชื่อหุ้น |
domain |
ชื่อโดเมนที่เชื่อมโยงกับองค์กร เช่น |
location |
สถานที่ตั้งของสํานักงานองค์กรที่บุคคลดังกล่าวทํางาน |
costCenter |
ศูนย์ต้นทุนของพนักงานในองค์กร |
fullTimeEquivalentMillipercent |
มิลลิวินาทีที่เทียบเท่ากับคนในองค์กร (100,000 = 100%) |
หมายเลขโทรศัพท์
หมายเลขโทรศัพท์ของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับหมายเลขโทรศัพท์ |
value |
หมายเลขโทรศัพท์ |
canonicalForm |
เอาต์พุตเท่านั้น รูปแบบ Canonical ITU-T E.164 ของหมายเลขโทรศัพท์ |
type |
ประเภทของหมายเลขโทรศัพท์ ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของหมายเลขโทรศัพท์ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
รูปภาพ
รูปภาพบุคคล ภาพที่แสดงข้างชื่อบุคคลเพื่อช่วยให้ผู้อื่นจดจําบุคคลนั้นได้
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับรูปภาพ |
url |
URL ของรูปภาพ คุณสามารถเปลี่ยนขนาดที่ต้องการได้โดยใส่พารามิเตอร์การค้นหา |
default |
จริงหากรูปภาพเป็นรูปภาพเริ่มต้น เท็จ หากรูปภาพเป็นรูปภาพที่ผู้ใช้ให้ไว้ |
ความสัมพันธ์
ความสัมพันธ์ระหว่างบุคคลหนึ่งกับอีกคน
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับความสัมพันธ์ |
person |
ชื่อของบุคคลอื่นที่ความสัมพันธ์นี้อ้างถึง |
type |
ความสัมพันธ์ของบุคคลดังกล่าวกับอีกฝ่ายหนึ่ง ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของความสัมพันธ์ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาที่ระบุไว้ในส่วนหัว HTTP ของภาษาที่ยอมรับ |
ความสนใจด้านความสัมพันธ์
เลิกใช้งานแล้ว: จะไม่มีการแสดงข้อมูลใดๆ ตามความสนใจของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับความสนใจในความสัมพันธ์ |
value |
ประเภทความสัมพันธ์ที่ผู้ใช้กําลังมองหา ค่านี้อาจเป็นค่าที่กําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าอย่างใดอย่างหนึ่งต่อไปนี้
|
formattedValue |
เอาต์พุตเท่านั้น ค่าของความสนใจในความสัมพันธ์ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาที่ระบุในส่วนหัว HTTP ของภาษาที่ยอมรับ |
สถานะความสัมพันธ์
เลิกใช้งานแล้ว: ระบบจะไม่ส่งข้อมูลสถานะความสัมพันธ์ของบุคคลกลับมา
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับสถานะความสัมพันธ์ |
value |
สถานะความสัมพันธ์ ค่านี้อาจเป็นค่าที่กําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าอย่างใดอย่างหนึ่งต่อไปนี้
|
formattedValue |
เอาต์พุตเท่านั้น ค่าของสถานะความสัมพันธ์ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
ที่พัก
เลิกใช้งานแล้ว: โปรดใช้ person.locations
แทน ที่พักอาศัยในอดีตหรือปัจจุบันของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับที่พักอาศัย |
value |
ที่อยู่ของที่พักอาศัย |
current |
เป็นจริงหาก ที่พักเป็นที่พํานักปัจจุบันของบุคคล เป็นเท็จ หากที่พักเป็นที่พํานักในอดีต |
ที่อยู่ Sip
ที่อยู่ SIP ของบุคคล ที่อยู่โปรโตคอลเริ่มต้นของเซสชันใช้สําหรับการสื่อสารของ VoIP เพื่อโทรด้วยเสียงหรือวิดีโอคอลผ่านอินเทอร์เน็ต
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับที่อยู่ SIP |
value |
ที่อยู่ SIP ในรูปแบบ URI SIP RFC 3261 19.1 |
type |
ประเภทของที่อยู่ SIP ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของที่อยู่ SIP ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาของส่วนหัว HTTP ของ |
ทักษะ
ทักษะที่บุคคลดังกล่าวมี
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับทักษะ |
value |
ทักษะ เช่น |
แท็กไลน์
เลิกใช้งานแล้ว: ระบบจะไม่แสดงข้อมูลรายละเอียดในบรรทัดสั้นๆ ของบุคคลนั้น
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับแท็กไลน์ |
value |
แท็กไลน์ |
URL
URL ที่เชื่อมโยงของบุคคล
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับ URL |
value |
URL |
type |
ประเภทของ URL ประเภทอาจเป็นกําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้
|
formattedType |
เอาต์พุตเท่านั้น ประเภทของ URL ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ |
ผู้ใช้กําหนด
ข้อมูลผู้ใช้ที่กําหนดเองซึ่งผู้ใช้ปลายทางสร้างขึ้น
การแสดง JSON |
---|
{
"metadata": {
object ( |
ช่อง | |
---|---|
metadata |
ข้อมูลเมตาเกี่ยวกับข้อมูลที่ผู้ใช้กําหนด |
key |
คีย์ที่ระบุของผู้ใช้ปลายทางของข้อมูลที่กําหนดโดยผู้ใช้ |
value |
มูลค่าที่ระบุของผู้ใช้ปลายทางของข้อมูลที่กําหนดโดยผู้ใช้ |
วิธีการ |
|
---|---|
|
สร้างกลุ่มรายชื่อติดต่อใหม่และส่งคืน PersonResponses สําหรับข้อมูล การส่งคําขออุปสงค์สําหรับผู้ใช้รายเดียวกันควรส่งตามลําดับเพื่อหลีกเลี่ยงเวลาในการตอบสนองและความล้มเหลวที่เพิ่มขึ้น |
|
ลบกลุ่มรายชื่อติดต่อ |
|
อัปเดตกลุ่มรายชื่อติดต่อและแสดงผลแผนที่ชื่อทรัพยากรเป็น PersonResponses สําหรับรายชื่อติดต่อที่อัปเดต |
|
สร้างรายชื่อติดต่อใหม่และส่งคืนทรัพยากรบุคคลสําหรับรายชื่อติดต่อนั้น |
|
ลบผู้ติดต่อ |
|
ลบรูปภาพของรายชื่อติดต่อ |
|
ระบุข้อมูลเกี่ยวกับบุคคลด้วยการระบุชื่อทรัพยากร |
|
ให้ข้อมูลเกี่ยวกับรายชื่อของบุคคลที่ระบุด้วยการระบุชื่อทรัพยากรที่ขอ |
|
ระบุรายชื่อโปรไฟล์ของโดเมนและรายชื่อติดต่อของโดเมนในไดเรกทอรีของโดเมนของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว |
|
ระบุรายการรายชื่อติดต่อในรายชื่อติดต่อที่จัดกลุ่มของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้วที่ตรงกับคําค้นหา |
|
ระบุรายการโปรไฟล์ของโดเมนและรายชื่อติดต่อของโดเมนในไดเรกทอรีโดเมนของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคําค้นหา |
|
อัปเดตข้อมูลติดต่อของผู้ติดต่อที่มีอยู่ |
|
อัปเดตรูปภาพของรายชื่อติดต่อ |