REST Resource: people

แหล่งข้อมูล: บุคคล

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

ช่องส่วนใหญ่สามารถใส่ได้หลายรายการ รายการในช่องไม่มีคำสั่งซื้อที่รับประกันการแสดงผล แต่รับประกันว่าช่องที่ไม่เว้นว่างไว้จะมีเพียง 1 ช่องที่ตั้งค่า metadata.primary เป็น "จริง"

การแสดง JSON 
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (PersonMetadata)
  },
  "addresses": [
    {
      object (Address)
    }
  ],
  "ageRange": enum (AgeRange),
  "ageRanges": [
    {
      object (AgeRangeType)
    }
  ],
  "biographies": [
    {
      object (Biography)
    }
  ],
  "birthdays": [
    {
      object (Birthday)
    }
  ],
  "braggingRights": [
    {
      object (BraggingRights)
    }
  ],
  "calendarUrls": [
    {
      object (CalendarUrl)
    }
  ],
  "clientData": [
    {
      object (ClientData)
    }
  ],
  "coverPhotos": [
    {
      object (CoverPhoto)
    }
  ],
  "emailAddresses": [
    {
      object (EmailAddress)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "externalIds": [
    {
      object (ExternalId)
    }
  ],
  "fileAses": [
    {
      object (FileAs)
    }
  ],
  "genders": [
    {
      object (Gender)
    }
  ],
  "imClients": [
    {
      object (ImClient)
    }
  ],
  "interests": [
    {
      object (Interest)
    }
  ],
  "locales": [
    {
      object (Locale)
    }
  ],
  "locations": [
    {
      object (Location)
    }
  ],
  "memberships": [
    {
      object (Membership)
    }
  ],
  "miscKeywords": [
    {
      object (MiscKeyword)
    }
  ],
  "names": [
    {
      object (Name)
    }
  ],
  "nicknames": [
    {
      object (Nickname)
    }
  ],
  "occupations": [
    {
      object (Occupation)
    }
  ],
  "organizations": [
    {
      object (Organization)
    }
  ],
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "relations": [
    {
      object (Relation)
    }
  ],
  "relationshipInterests": [
    {
      object (RelationshipInterest)
    }
  ],
  "relationshipStatuses": [
    {
      object (RelationshipStatus)
    }
  ],
  "residences": [
    {
      object (Residence)
    }
  ],
  "sipAddresses": [
    {
      object (SipAddress)
    }
  ],
  "skills": [
    {
      object (Skill)
    }
  ],
  "taglines": [
    {
      object (Tagline)
    }
  ],
  "urls": [
    {
      object (Url)
    }
  ],
  "userDefined": [
    {
      object (UserDefined)
    }
  ]
}
ช่อง
resourceName

string

ชื่อทรัพยากรสำหรับบุคคลที่เซิร์ฟเวอร์กำหนด สตริง ASCII ในรูปแบบของ people/{person_id}
etag

string

แท็กเอนทิตี HTTP ของทรัพยากร ใช้สำหรับการตรวจสอบเว็บแคช
metadata

object (PersonMetadata)

เอาต์พุตเท่านั้น ข้อมูลเมตาเกี่ยวกับบุคคล
addresses[]

object (Address)

ที่อยู่ของบุคคล
ageRange
(deprecated)

enum (AgeRange)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว (โปรดใช้ person.ageRanges แทน)

ช่วงอายุของบุคคลนั้น
ageRanges[]

object (AgeRangeType)

เอาต์พุตเท่านั้น ช่วงอายุของบุคคลนั้น
biographies[]

object (Biography)

ชีวประวัติของบุคคลนั้น ฟิลด์นี้เป็น Singleton สำหรับแหล่งที่มาของที่อยู่ติดต่อ
birthdays[]

object (Birthday)

วันเกิดของบุคคลนั้น ฟิลด์นี้เป็น Singleton สำหรับแหล่งที่มาของที่อยู่ติดต่อ
braggingRights[]
(deprecated)

object (BraggingRights)

เลิกใช้งานแล้ว: จะไม่มีการส่งกลับข้อมูลเรื่องสิทธิ์ในการโม้ให้แก่บุคคลนั้น
calendarUrls[]

object (CalendarUrl)

URL ปฏิทินของบุคคล
clientData[]

object (ClientData)

ข้อมูลไคลเอ็นต์ของบุคคลดังกล่าว
coverPhotos[]

object (CoverPhoto)

เอาต์พุตเท่านั้น รูปภาพปกของบุคคลดังกล่าว
emailAddresses[]

object (EmailAddress)

อีเมลของบุคคลนั้น สำหรับ people.connections.list และ otherContacts.list จำนวนที่อยู่อีเมลจำกัดไว้ที่ 100 รายการ หากผู้ใช้มีอีเมลมากกว่า ผู้ใช้ทั้งกลุ่มจะรับทั้งกลุ่มได้โดยโทรไปที่ people.getBatchGet
events[]

object (Event)

เหตุการณ์ของบุคคลนั้น
externalIds[]

object (ExternalId)

รหัสภายนอกของบุคคลนั้น
fileAses[]

object (FileAs)

File-ases ของบุคคลที่ต้องการ
genders[]

object (Gender)

เพศของผู้ใช้ ฟิลด์นี้เป็น Singleton สำหรับแหล่งที่มาของที่อยู่ติดต่อ
imClients[]

object (ImClient)

โปรแกรมรับส่งข้อความโต้ตอบแบบทันทีของบุคคลนั้น
interests[]

object (Interest)

ความสนใจของบุคคล
locales[]

object (Locale)

ค่ากำหนดภาษาของบุคคลนั้น
locations[]

object (Location)

ตําแหน่งของบุคคล
memberships[]

object (Membership)

การเป็นสมาชิกกลุ่มของบุคคลนั้น
miscKeywords[]

object (MiscKeyword)

คีย์เวิร์ดเบ็ดเตล็ดของบุคคลนั้น
names[]

object (Name)

ชื่อบุคคลนั้น ฟิลด์นี้เป็น Singleton สำหรับแหล่งที่มาของที่อยู่ติดต่อ
nicknames[]

object (Nickname)

ชื่อเล่นของบุคคลนั้น
occupations[]

object (Occupation)

อาชีพของบุคคลนั้น
organizations[]

object (Organization)

องค์กรในอดีตหรือองค์กรปัจจุบันของบุคคลนั้น
phoneNumbers[]

object (PhoneNumber)

หมายเลขโทรศัพท์ของบุคคลนั้น สำหรับ people.connections.list และ otherContacts.list จำนวนหมายเลขโทรศัพท์จำกัดไว้ที่ 100 หมายเลข หากผู้ใช้รายหนึ่งมีหมายเลขโทรศัพท์เพิ่มเติม หมายเลขทั้งชุดจะรับได้โดยโทรไปที่ people.getBatchGet
photos[]

object (Photo)

เอาต์พุตเท่านั้น รูปภาพของบุคคลนั้น
relations[]

object (Relation)

ความสัมพันธ์ของบุคคลนั้น
relationshipInterests[]
(deprecated)

object (RelationshipInterest)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลข้อมูลความสนใจด้านความสัมพันธ์ของบุคคลนั้น
relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลข้อมูลสถานะความสัมพันธ์ของบุคคล
residences[]
(deprecated)

object (Residence)

เลิกใช้งานแล้ว: (โปรดใช้ person.locations แทน) ที่พักอาศัยของบุคคลนั้น
sipAddresses[]

object (SipAddress)

ที่อยู่ SIP ของบุคคลนั้น
skills[]

object (Skill)

ทักษะของบุคคล
taglines[]
(deprecated)

object (Tagline)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลข้อมูลแท็กไลน์ของบุคคล
urls[]

object (Url)

URL ที่เกี่ยวข้องของบุคคล
userDefined[]

object (UserDefined)

ข้อมูลที่กำหนดโดยผู้ใช้ของบุคคลนั้น

PersonMetadata

ข้อมูลเมตาเกี่ยวกับบุคคล

การแสดง JSON 
{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}
ช่อง
sources[]

object (Source)

แหล่งที่มาของข้อมูลสำหรับบุคคล
previousResourceNames[]

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรเดิมที่บุคคลนี้มี ป้อนข้อมูลสําหรับคําขอ people.connections.list ที่มีโทเค็นการซิงค์เท่านั้น

ชื่อทรัพยากรอาจเปลี่ยนแปลงเมื่อเพิ่มหรือนำช่องที่ลิงก์รายชื่อติดต่อและโปรไฟล์ออก เช่น อีเมลที่ยืนยันแล้ว หมายเลขโทรศัพท์ที่ยืนยันแล้ว หรือ URL ของโปรไฟล์
linkedPeopleResourceNames[]

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของบุคคลที่ลิงก์กับทรัพยากรนี้
deleted

boolean

เอาต์พุตเท่านั้น เป็นจริงหากทรัพยากรบุคคลถูกลบ ป้อนข้อมูลสำหรับคำขอซิงค์ people.connections.list และ otherContacts.list เท่านั้น
objectType
(deprecated)

enum (ObjectType)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว (โปรดใช้ person.metadata.sources.profileMetadata.objectType แทน)

ประเภทของออบเจ็กต์บุคคล

แหล่งที่มา

แหล่งที่มาของช่อง

การแสดง JSON 
{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}
ช่อง
type

enum (SourceType)

ประเภทแหล่งที่มา
id

string

ตัวระบุที่ไม่ซ้ำกันภายในประเภทต้นทางที่เซิร์ฟเวอร์สร้างขึ้น
etag

string

ป้อนข้อมูลใน person.metadata.sources เท่านั้น

แท็กเอนทิตี HTTP ของแหล่งที่มา ใช้สำหรับการตรวจสอบเว็บแคช
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น ป้อนข้อมูลใน person.metadata.sources เท่านั้น

การประทับเวลาอัปเดตล่าสุดของแหล่งที่มานี้

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ฟิลด์สหภาพ metadata ป้อนข้อมูลใน person.metadata.sources เท่านั้น

ข้อมูลเมตาเกี่ยวกับแหล่งที่มา metadata ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
profileMetadata

object (ProfileMetadata)

เอาต์พุตเท่านั้น ป้อนข้อมูลใน person.metadata.sources เท่านั้น

ข้อมูลเมตาเกี่ยวกับแหล่งที่มาของประเภท PROFILE

SourceType

ประเภทของแหล่งที่มา

Enum
SOURCE_TYPE_UNSPECIFIED ไม่ระบุ
ACCOUNT บัญชี Google
PROFILE โปรไฟล์ Google คุณดูโปรไฟล์ได้ที่ https://profiles.google.com/{id} โดย {id} เป็นรหัสแหล่งที่มา
DOMAIN_PROFILE โปรไฟล์ในโดเมน Google Workspace
CONTACT รายชื่อติดต่อของ Google ดูรายชื่อติดต่อได้ที่ https://contact.google.com/{id} โดย {id} เป็นรหัสต้นทาง
OTHER_CONTACT "รายชื่อติดต่ออื่นๆ" ของ Google
DOMAIN_CONTACT รายชื่อติดต่อที่แชร์ของโดเมน Google Workspace

ProfileMetadata

ข้อมูลเมตาเกี่ยวกับโปรไฟล์

การแสดง JSON 
{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}
ช่อง
objectType

enum (ObjectType)

เอาต์พุตเท่านั้น ประเภทออบเจ็กต์โปรไฟล์
userTypes[]

enum (UserType)

เอาต์พุตเท่านั้น ผู้ใช้พิมพ์

ObjectType

ประเภทของออบเจ็กต์บุคคล

Enum
OBJECT_TYPE_UNSPECIFIED ไม่ระบุ
PERSON บุคคล
PAGE หน้า Currents

UserType

ประเภทของผู้ใช้

Enum
USER_TYPE_UNKNOWN ไม่ทราบประเภทผู้ใช้
GOOGLE_USER ผู้ใช้คือผู้ใช้ Google
GPLUS_USER ผู้ใช้รายนั้นเป็นผู้ใช้ Currents
GOOGLE_APPS_USER ผู้ใช้คือผู้ใช้ Google Workspace

ที่อยู่

ที่อยู่จริงของบุคคล โดยอาจเป็นตู้ ปณ. หรือที่อยู่ ไม่จำเป็นต้องกรอกข้อมูลครบทุกช่อง

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับที่อยู่
formattedValue

string

ค่าที่ไม่มีโครงสร้างของที่อยู่ หากผู้ใช้ไม่ได้ตั้งค่านี้ไว้ ระบบจะสร้างขึ้นจากค่าที่มีโครงสร้างโดยอัตโนมัติ
type

string

ประเภทของที่อยู่ โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • work
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของที่อยู่ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language
poBox

string

ตู้ ปณ. ของที่อยู่
streetAddress

string

ที่อยู่
extendedAddress

string

ที่อยู่แบบขยายของที่อยู่ เช่น เลขที่อพาร์ตเมนต์
city

string

เมืองของที่อยู่
region

string

ภูมิภาคของที่อยู่ เช่น รัฐหรือจังหวัด
postalCode

string

รหัสไปรษณีย์ของที่อยู่
country

string

ประเทศของที่อยู่
countryCode

string

รหัสประเทศ ISO 3166-1 alpha-2 ของที่อยู่

FieldMetadata

ข้อมูลเมตาเกี่ยวกับช่อง

การแสดง JSON 
{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}
ช่อง
primary

boolean

เอาต์พุตเท่านั้น เป็นจริงหากฟิลด์นี้เป็นช่องหลักสำหรับแหล่งที่มาทั้งหมดในบุคคลนั้นๆ ผู้ใช้แต่ละคนจะมีช่องไม่เกิน 1 ช่องโดยตั้งค่า primary เป็น "จริง"
sourcePrimary

boolean

เป็นจริงหากช่องนี้เป็นช่องหลักของ source แต่ละแหล่งที่มาต้องมีไม่เกิน 1 ช่องโดยตั้งค่า sourcePrimary เป็น "จริง"
verified

boolean

เอาต์พุตเท่านั้น เป็นจริงหากช่องได้รับการยืนยันแล้ว เป็นเท็จ หากช่องไม่ได้รับการยืนยัน โดยทั่วไป ช่องที่ได้รับการยืนยันคือชื่อ อีเมล หมายเลขโทรศัพท์ หรือเว็บไซต์ที่ได้รับการยืนยันว่าเป็นของบุคคลนั้น
source

object (Source)

แหล่งที่มาของฟิลด์

AgeRange

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

ช่วงอายุของบุคคล

Enum
AGE_RANGE_UNSPECIFIED ไม่ระบุ
LESS_THAN_EIGHTEEN อายุต่ำกว่า 18 ปี
EIGHTEEN_TO_TWENTY ระหว่าง 18 ถึง 20
TWENTY_ONE_OR_OLDER 21 ปีขึ้นไป

AgeRangeType

ช่วงอายุของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับช่วงอายุ
ageRange

enum (AgeRange)

ช่วงอายุ

ชีวประวัติ

ประวัติสั้นๆ ของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับชีวประวัติ
value

string

ประวัติสั้นๆ
contentType

enum (ContentType)

ประเภทเนื้อหาของชีวประวัติ

ContentType

ประเภทของเนื้อหา

Enum
CONTENT_TYPE_UNSPECIFIED ไม่ระบุ
TEXT_PLAIN ข้อความธรรมดา
TEXT_HTML ข้อความ HTML

วันเกิด

วันเกิดของบุคคล ระบุช่อง date และ text อย่างน้อย 1 ช่อง โดยปกติแล้ว ช่อง date และ text จะแสดงวันที่เดียวกัน แต่ไม่รับประกันว่าจะปรากฏ ลูกค้าควรตั้งค่าช่อง date เสมอเมื่อเปลี่ยนแปลงวันเกิด

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับวันเกิด
date

object (Date)

วันที่มีโครงสร้างของวันเกิด
text
(deprecated)

string

ต้องการใช้ช่อง date หากมีการตั้งค่าแล้ว

สตริงรูปแบบอิสระที่แสดงถึงวันเกิดของผู้ใช้ ค่านี้ไม่ได้รับการตรวจสอบ

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลามีการระบุไว้ที่อื่นหรือไม่มีนัยสำคัญ โดยวันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจแสดงถึงข้อใดข้อหนึ่งต่อไปนี้

  • วันที่แบบเต็มซึ่งมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • ผ่านไป 1 ปี โดยมี 0 เดือนกับ 0 วัน
  • ปีและเดือนที่มี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง:

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือปีและเดือนที่วันไม่เป็นนัยสำคัญ

BraggingRights

เลิกใช้งานแล้ว: จะไม่มีการส่งคืนข้อมูลสิทธิ์โม้ของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับสิทธิ์ในการโม้
value

string

เรื่องจริงไม่ได้โม้ เช่น climbed mount everest

CalendarUrl

URL ปฏิทินของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับ URL ของปฏิทิน
url

string

URL ของปฏิทิน
type

string

ประเภทของ URL ปฏิทิน โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • freeBusy
  • work
formattedType

string

เอาต์พุตเท่านั้น ประเภทของ URL ปฏิทินที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language

ClientData

ข้อมูลไคลเอ็นต์ที่กําหนดเองซึ่งลูกค้าสร้างขึ้น อนุญาตให้มีคีย์และค่าซ้ำกัน

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับข้อมูลไคลเอ็นต์
key

string

ไคลเอ็นต์ระบุคีย์ของข้อมูลไคลเอ็นต์
value

string

ค่าที่ลูกค้าระบุของข้อมูลไคลเอ็นต์

CoverPhoto

รูปภาพปกของบุคคล รูปภาพขนาดใหญ่ที่แสดงในหน้าโปรไฟล์ของบุคคลนั้นซึ่งแสดงถึงตัวตนหรือสิ่งที่พวกเขาสนใจ

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับรูปภาพปก
url

string

URL ของรูปภาพปก
default

boolean

เป็นจริงหากรูปภาพปกเป็นรูปภาพปกเริ่มต้น เป็นเท็จ หากรูปภาพปกเป็นรูปภาพปกที่ผู้ใช้ระบุ

EmailAddress

อีเมลของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับอีเมล
value

string

อีเมล
type

string

ประเภทของอีเมล โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • work
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของอีเมลที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language
displayName

string

ชื่อที่แสดงของอีเมล

เหตุการณ์

เหตุการณ์ที่เกี่ยวข้องกับบุคคลดังกล่าว

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับเหตุการณ์
date

object (Date)

วันที่เกิดเหตุการณ์
type

string

ประเภทของกิจกรรม โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • anniversary
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของเหตุการณ์ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language

ExternalId

ตัวระบุจากบุคคลภายนอกที่เกี่ยวข้องกับบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับรหัสภายนอก
value

string

ค่าของรหัสภายนอก
type

string

ประเภทของรหัสภายนอก โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

เอาต์พุตเท่านั้น ประเภทของเหตุการณ์ที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language

FileAs

ชื่อที่ควรใช้ในการจัดเรียงบุคคลในรายชื่อ

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับไฟล์เป็น
value

string

ค่า "เก็บเป็น"

เพศ

เพศของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับเพศ
value

string

เพศสำหรับบุคคล คุณสามารถกำหนดเพศเองหรือค่าใดค่าหนึ่งต่อไปนี้

  • male
  • female
  • unspecified
formattedValue

string

เอาต์พุตเท่านั้น ค่าของเพศที่แปลและจัดรูปแบบเป็นภาษาบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language ไม่ได้ระบุค่าหรือค่าที่กำหนดเองที่ไม่มีการแปล
addressMeAs

string

ช่องข้อความรูปแบบอิสระสำหรับคำสรรพนามที่จะใช้เพื่อกล่าวถึงบุคคล ค่าทั่วไปมีดังนี้

  • he/him
  • she/her
  • they/them

ImClient

โปรแกรมรับส่งข้อความโต้ตอบแบบทันทีของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับไคลเอ็นต์ IM
username

string

ชื่อผู้ใช้ที่ใช้ในโปรแกรม IM
type

string

ประเภทของไคลเอ็นต์ IM โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • work
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของไคลเอ็นต์ IM ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language
protocol

string

โปรโตคอลของไคลเอ็นต์ IM โปรโตคอลสามารถกำหนดเองหรือมีค่าที่กำหนดไว้ล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • aim
  • msn
  • yahoo
  • skype
  • qq
  • googleTalk
  • icq
  • jabber
  • netMeeting
formattedProtocol

string

เอาต์พุตเท่านั้น โปรโตคอลของไคลเอ็นต์ IM ที่จัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language

ความสนใจ

ความสนใจของบุคคลคนหนึ่ง

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับความสนใจ
value

string

ความสนใจ เช่น stargazing

ภาษา

ค่ากำหนดภาษาของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับภาษา
value

string

แท็กภาษา IETF BCP 47 ที่มีการจัดรูปแบบอย่างดีที่แสดงถึงภาษาดังกล่าว

ตำแหน่ง

ตําแหน่งของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับสถานที่
value

string

ค่ารูปแบบอิสระของสถานที่ตั้ง
type

string

ประเภทของสถานที่ โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • desk
  • grewUp
current

boolean

สถานที่ตั้งนั้นคือตำแหน่งปัจจุบันหรือไม่
buildingId

string

ตัวระบุอาคาร
floor

string

ชื่อหรือหมายเลขชั้น
floorSection

string

ส่วนชั้นใน floor_name
deskCode

string

ตำแหน่งของโต๊ะทำงานส่วนบุคคล

การเป็นสมาชิก

การเป็นสมาชิกกลุ่มของบุคคล แก้ไขได้เฉพาะการเป็นสมาชิกกลุ่มของรายชื่อติดต่อเท่านั้น

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับการเป็นสมาชิก
ฟิลด์สหภาพ membership การเป็นสมาชิก membership ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contactGroupMembership

object (ContactGroupMembership)

การเป็นสมาชิกกลุ่มรายชื่อติดต่อ
domainMembership

object (DomainMembership)

เอาต์พุตเท่านั้น การเป็นสมาชิกโดเมน

ContactGroupMembership

การเป็นสมาชิกกลุ่มรายชื่อติดต่อของ Google

การแสดง JSON 
{
  "contactGroupId": string,
  "contactGroupResourceName": string
}
ช่อง
contactGroupId
(deprecated)

string

เอาต์พุตเท่านั้น รหัสกลุ่มรายชื่อติดต่อสำหรับการเป็นสมาชิกกลุ่มรายชื่อติดต่อ
contactGroupResourceName

string

ชื่อทรัพยากรสำหรับกลุ่มรายชื่อติดต่อที่เซิร์ฟเวอร์กำหนด สตริง ASCII ในรูปแบบของ contactGroups/{contactGroupId} มีเพียง contactGroupResourceName เท่านั้นที่จะใช้แก้ไขการเป็นสมาชิกได้ คุณสามารถนำการเป็นสมาชิกกลุ่มรายชื่อติดต่อออกได้ แต่จะเพิ่มได้เฉพาะสมาชิกกลุ่มหรือกลุ่มระบบ "myContacts" หรือ "ที่ติดดาว" เท่านั้น ผู้ติดต่อต้องมีการเป็นสมาชิกกลุ่มรายชื่อติดต่ออย่างน้อย 1 รายการเสมอ

DomainMembership

การเป็นสมาชิกโดเมน Google Workspace

การแสดง JSON 
{
  "inViewerDomain": boolean
}
ช่อง
inViewerDomain

boolean

เป็นจริงหากบุคคลดังกล่าวอยู่ในโดเมน Google Workspace ของผู้ชม

MiscKeyword

คีย์เวิร์ดเบ็ดเตล็ดของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับคีย์เวิร์ดเบ็ดเตล็ด
value

string

มูลค่าของคีย์เวิร์ดเบ็ดเตล็ด
type

enum (KeywordType)

ประเภทคีย์เวิร์ดเบ็ดเตล็ด
formattedType

string

เอาต์พุตเท่านั้น ประเภทคีย์เวิร์ดเบ็ดเตล็ดที่มีการแปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language

KeywordType

ประเภทคีย์เวิร์ดเบ็ดเตล็ด

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 (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับชื่อ
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงจะจัดรูปแบบตามภาษาที่บัญชีของผู้ดูระบุหรือส่วนหัว HTTP ของ Accept-Language
displayNameLastFirst

string

เอาต์พุตเท่านั้น ชื่อที่แสดงพร้อมนามสกุลจะจัดรูปแบบตามภาษาที่ระบุโดยบัญชีของผู้ดูหรือส่วนหัว HTTP ของ Accept-Language
unstructuredName

string

ค่าชื่อรูปแบบอิสระ
familyName

string

นามสกุล
givenName

string

ชื่อจริง
middleName

string

ชื่อกลาง
honorificPrefix

string

คำนำหน้าที่เหมาะสม เช่น Mrs. หรือ Dr.
honorificSuffix

string

คำต่อท้ายที่ปรากฏ เช่น Jr.
phoneticFullName

string

ชื่อและนามสกุลสะกดตามการออกเสียง
phoneticFamilyName

string

นามสกุลสะกดตามการออกเสียง
phoneticGivenName

string

ชื่อที่สะกดตามการออกเสียง
phoneticMiddleName

string

ชื่อกลางสะกดตามการออกเสียง
phoneticHonorificPrefix

string

คำนำหน้าที่น่าจดจำสะกดตามการออกเสียง
phoneticHonorificSuffix

string

คำเสริมท้ายที่เป็นเกียรติคุณสะกดตามการออกเสียง

ชื่อเล่น

ชื่อเล่นของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับชื่อเล่น
value

string

ชื่อเล่น
type

enum (NicknameType)

ประเภทของชื่อเล่น

NicknameType

ประเภทของชื่อเล่น

Enum
DEFAULT ชื่อเล่นทั่วไป
MAIDEN_NAME

นามสกุลเดิมหรือนามสกุลกำเนิด ใช้เมื่อนามสกุลของบุคคลนั้นมีการเปลี่ยนแปลงอันเป็นผลจากการแต่งงาน
INITIALS

ชื่อย่อ
GPLUS

ชื่อเล่นของโปรไฟล์ Google+
OTHER_NAME

ความเกี่ยวข้องทางวิชาชีพหรือชื่ออื่น เช่น Dr. Smith.
ALTERNATE_NAME ชื่อสำรองคือบุคคลที่เรารู้จัก
SHORT_NAME

ชื่อที่สั้นกว่าของชื่อบุคคล

อาชีพ

อาชีพของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับอาชีพ
value

string

อาชีพ เช่น carpenter

องค์กร

องค์กรในอดีตหรือองค์กรปัจจุบันของบุคคล อนุญาตให้มีช่วงวันที่ซ้อนทับกัน

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับองค์กร
type

string

ประเภทขององค์กร โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • work
  • school
formattedType

string

เอาต์พุตเท่านั้น ประเภทขององค์กรที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language
startDate

object (Date)

วันที่เริ่มต้นที่บุคคลนั้นเข้าร่วมองค์กร
endDate

object (Date)

วันที่สิ้นสุดที่บุคคลนั้นออกจากองค์กร
current

boolean

เป็นจริงหากองค์กรเป็นองค์กรปัจจุบันของผู้ใช้ เท็จหากองค์กรเป็นองค์กรในอดีต
name

string

ชื่อขององค์กร
phoneticName

string

คำอ่านชื่อองค์กร
department

string

แผนกของบุคคลในองค์กร
title

string

ตำแหน่งงานของบุคคลนั้นในองค์กร
jobDescription

string

คําบรรยายลักษณะงานของบุคคลในองค์กร
symbol

string

สัญลักษณ์ที่เกี่ยวข้องกับองค์กร เช่น สัญลักษณ์หุ้น ตัวย่อ หรือคำย่อ
domain

string

ชื่อโดเมนที่เชื่อมโยงกับองค์กร เช่น google.com
location

string

สถานที่ตั้งของสำนักงานขององค์กรที่ผู้ใช้ทำงานอยู่
costCenter

string

ศูนย์ต้นทุนของบุคคลในองค์กร
fullTimeEquivalentMillipercent

integer

เทียบเท่ากับเต็มเวลาของบุคคลในองค์กร (100,000 = 100%)

PhoneNumber

หมายเลขโทรศัพท์ของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับหมายเลขโทรศัพท์
value

string

หมายเลขโทรศัพท์
canonicalForm

string

เอาต์พุตเท่านั้น หมายเลขโทรศัพท์ในรูปแบบ ITU-T E.164 ที่กำหนดหน้าแล้ว
type

string

ประเภทของหมายเลขโทรศัพท์ โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • work
  • mobile
  • homeFax
  • workFax
  • otherFax
  • pager
  • workMobile
  • workPager
  • main
  • googleVoice
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทหมายเลขโทรศัพท์ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language

รูปภาพ

รูปภาพของบุคคล รูปภาพที่แสดงข้างชื่อบุคคลนั้นเพื่อช่วยให้ผู้อื่นจดจำบุคคลนั้นได้

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับรูปภาพ
url

string

URL ของรูปภาพ คุณเปลี่ยนขนาดที่ต้องการได้โดยเพิ่มพารามิเตอร์การค้นหา sz={size} ต่อท้าย URL โดยที่ {size} คือขนาดเป็นพิกเซล ตัวอย่างเช่น https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
default

boolean

"จริง" หากรูปภาพเป็นรูปภาพเริ่มต้น "เท็จ" หากรูปภาพนั้นเป็นรูปภาพที่ผู้ใช้ให้ไว้

ความสัมพันธ์

ความเกี่ยวข้องของบุคคลหนึ่งๆ กับบุคคลอื่น

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับความสัมพันธ์
person

string

ชื่อของบุคคลอื่นที่ความสัมพันธ์นี้อ้างถึง
type

string

ความสัมพันธ์ของบุคคลนั้นกับอีกฝ่าย โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • spouse
  • child
  • mother
  • father
  • parent
  • brother
  • sister
  • friend
  • relative
  • domesticPartner
  • manager
  • assistant
  • referredBy
  • partner
formattedType

string

เอาต์พุตเท่านั้น ประเภทของความสัมพันธ์ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาที่ระบุในส่วนหัว HTTP ที่ยอมรับ

RelationshipInterest

เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลข้อมูลความสนใจด้านความสัมพันธ์ของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับความสนใจในความสัมพันธ์
value

string

ความสัมพันธ์แบบที่บุคคลนั้นกำลังมองหา ค่าสามารถกำหนดเองหรือค่าใดค่าหนึ่งที่กำหนดไว้ล่วงหน้าต่อไปนี้

  • friend
  • date
  • relationship
  • networking
formattedValue

string

เอาต์พุตเท่านั้น ค่าของความสนใจความสัมพันธ์จะแปลและจัดรูปแบบเป็นภาษาบัญชีของผู้ชมหรือภาษาที่ระบุในส่วนหัว HTTP ที่ยอมรับได้

RelationshipStatus

เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลสถานะความสัมพันธ์ของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับสถานะความสัมพันธ์
value

string

สถานะความสัมพันธ์ ค่าสามารถกำหนดเองหรือค่าใดค่าหนึ่งที่กำหนดไว้ล่วงหน้าต่อไปนี้

  • single
  • inARelationship
  • engaged
  • married
  • itsComplicated
  • openRelationship
  • widowed
  • inDomesticPartnership
  • inCivilUnion
formattedValue

string

เอาต์พุตเท่านั้น ค่าของสถานะความสัมพันธ์ที่แปลและจัดรูปแบบเป็นภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language

ที่พัก

เลิกใช้งานแล้ว: โปรดใช้ person.locations แทน ที่อยู่ในอดีตหรือปัจจุบันของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับที่พักอาศัย
value

string

ที่อยู่ของที่พักอาศัย
current

boolean

จริงหากผู้พำนักอาศัยเป็นที่พำนักปัจจุบันของบุคคลนั้น เท็จหากเป็นที่อยู่อาศัยที่ผ่านมาแล้ว

SipAddress

ที่อยู่ SIP ของบุคคล ที่อยู่โปรโตคอลเริ่มต้นของเซสชันใช้สำหรับการสื่อสาร VoIP เพื่อโทรด้วยเสียงหรือวิดีโอคอลผ่านอินเทอร์เน็ต

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับที่อยู่ SIP
value

string

ที่อยู่ SIP ในรูปแบบ URI ของ SIP RFC 3261 19.1
type

string

ประเภทของที่อยู่ SIP ประเภทอาจเป็นแบบกำหนดเองหรือค่าใดค่าหนึ่งที่กำหนดไว้ล่วงหน้าต่อไปนี้

  • home
  • work
  • mobile
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของที่อยู่ SIP ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัว HTTP ของ Accept-Language

ทักษะ

ทักษะที่บุคคลนั้นมี

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับทักษะ
value

string

ทักษะ เช่น underwater basket weaving

แท็กไลน์

เลิกใช้งานแล้ว: ระบบจะไม่แสดงผลข้อมูล คำอธิบายสั้นๆ บรรทัดเดียวของบุคคลดังกล่าว

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับแท็กไลน์
value

string

แท็กไลน์

URL

URL ที่เชื่อมโยงของบุคคล

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับ URL
value

string

URL
type

string

ประเภทของ URL โดยสามารถกำหนดเองหรือมีค่าที่กำหนดล่วงหน้าค่าใดค่าหนึ่งต่อไปนี้

  • home
  • work
  • blog
  • profile
  • homePage
  • ftp
  • reservations
  • appInstallPage: เว็บไซต์สำหรับแอปพลิเคชัน Currents
  • other
formattedType

string

เอาต์พุตเท่านั้น ประเภทของ URL ที่แปลและจัดรูปแบบในภาษาของบัญชีของผู้ชมหรือภาษาส่วนหัวของ HTTP ของ Accept-Language

UserDefined

ข้อมูลผู้ใช้ที่กำหนดเองซึ่งสร้างขึ้นโดยผู้ใช้ปลายทาง

การแสดง JSON 
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
ช่อง
metadata

object (FieldMetadata)

ข้อมูลเมตาเกี่ยวกับข้อมูลที่ผู้ใช้กำหนด
key

string

คีย์ที่ผู้ใช้ปลายทางระบุสำหรับข้อมูลที่กำหนดโดยผู้ใช้
value

string

ค่าที่ผู้ใช้ระบุของข้อมูลที่กำหนดโดยผู้ใช้

วิธีการ

batchCreateContacts

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

ควรส่งคำขอเปลี่ยนแปลงคำขอสำหรับผู้ใช้รายเดียวกันตามลำดับเพื่อหลีกเลี่ยงเวลาในการตอบสนองและความล้มเหลวที่เพิ่มขึ้น

batchDeleteContacts

 ลบกลุ่มรายชื่อติดต่อ

batchUpdateContacts

 อัปเดตกลุ่มรายชื่อติดต่อแล้วส่งกลับแผนที่ของชื่อทรัพยากรไปยัง PersonResponses สำหรับรายชื่อติดต่อที่อัปเดต

createContact

 สร้างรายชื่อติดต่อใหม่และส่งคืนทรัพยากรบุคคลสำหรับรายชื่อติดต่อนั้น

deleteContact

 ลบผู้ติดต่อ

deleteContactPhoto

 ลบรูปภาพของรายชื่อติดต่อ

get

 ให้ข้อมูลเกี่ยวกับบุคคลโดยระบุชื่อทรัพยากร

getBatchGet

 ให้ข้อมูลเกี่ยวกับรายชื่อบุคคลที่ระบุ โดยระบุรายชื่อทรัพยากรที่ขอ

listDirectoryPeople

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

searchContacts

 ระบุรายชื่อติดต่อในรายชื่อติดต่อในกลุ่มของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคำค้นหา

searchDirectoryPeople

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

updateContact

 อัปเดตข้อมูลรายชื่อติดต่อของบุคคลที่ติดต่อที่มีอยู่

updateContactPhoto

 อัปเดตรูปภาพของรายชื่อติดต่อ