REST Resource: people

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

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

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

การแสดง 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)

ชีวประวัติของบุคคลนั้น ฟิลด์นี้เป็นฟิลด์เดี่ยวสําหรับแหล่งที่มาของรายชื่อติดต่อ

birthdays[]

object (Birthday)

วันเกิดของบุคคลนั้น ฟิลด์นี้เป็นฟิลด์เดี่ยวสําหรับแหล่งที่มาของรายชื่อติดต่อ

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)

ชื่อไฟล์ของบุคคลดังกล่าว

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)

หมายเลขโทรศัพท์ของบุคคลนั้น สำหรับ 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

ที่อยู่

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

การแสดง 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

ตู้ ป.ณ. (P.O.) ของที่อยู่

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

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

source

object (Source)

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

ช่วงอายุ

เลิกใช้งานแล้ว (โปรดใช้ 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 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

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

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

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี

month

integer

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

day

integer

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

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

ค่า "File-as"

เพศ

เพศของบุคคล

การแสดง 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%)

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

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

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

object (FieldMetadata)

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

value

string

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

canonicalForm

string

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

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

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