REST Resource: people

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

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

ช่องส่วนใหญ่มีหลายรายการได้ รายการในช่องไม่มีคําสั่งซื้อที่รับประกันการแสดงผล แต่รับประกันว่าช่องที่ไม่ว่างเปล่าแต่ละช่องจะมีช่องเดียวที่กําหนด 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)

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

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)

ข้อมูลที่ผู้ใช้กําหนดไว้ของผู้ใช้

ข้อมูลเมตาของบุคคล

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

การแสดง 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,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}
ช่อง
type

enum (SourceType)

ประเภทของแหล่งข้อมูล

id

string

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

etag

string

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

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

updateTime

string (Timestamp format)

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

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

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

profileMetadata

object (ProfileMetadata)

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

ข้อมูลเมตาเกี่ยวกับแหล่งที่มาของประเภท 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 (UserType)
  ]
}
ช่อง
objectType

enum (ObjectType)

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

userTypes[]

enum (UserType)

เอาต์พุตเท่านั้น ประเภทของผู้ใช้

ประเภทออบเจ็กต์

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

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 (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 ของที่อยู่

ข้อมูลเมตาของช่อง

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

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

boolean

เอาต์พุตเท่านั้น เป็นจริงหากช่องนี้เป็นช่องหลักสําหรับแหล่งที่มาทั้งหมดในบุคคล แต่ละคนจะมีช่องได้ไม่เกิน 1 ช่องซึ่งตั้งค่าเป็น primary เป็น "จริง"

sourcePrimary

boolean

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

verified

boolean

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

source

object (Source)

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

ช่วงอายุ

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

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

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

ประเภทช่วงอายุ

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

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

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

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

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

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 ปี (เช่น วันครบรอบ)
  • 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 เพื่อระบุปีที่กําหนดเองหรือปีและเดือนที่ไม่สําคัญ

สิทธิ์ในการโม้

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

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

object (FieldMetadata)

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

value

string

สิทธิ์ในการโม้ เช่น climbed mount everest

URL ของปฏิทิน

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

ข้อมูลลูกค้า

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

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

object (FieldMetadata)

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

key

string

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

value

string

ค่าที่ลูกค้าระบุของข้อมูลลูกค้า

รูปภาพปก

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

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

FileA

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

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

ไคลเอ็นต์

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

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

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

ช่อง Union membership การเป็นสมาชิก membership ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
contactGroupMembership

object (ContactGroupMembership)

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

domainMembership

object (DomainMembership)

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

ข้อมูลติดต่อกลุ่ม

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

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

string

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

contactGroupResourceName

string

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

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

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

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

boolean

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

คีย์เวิร์ดอื่นๆ

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

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

object (FieldMetadata)

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

value

string

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

type

enum (KeywordType)

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

formattedType

string

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

ประเภทคีย์เวิร์ด

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

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)

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

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

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

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

เอาต์พุตเท่านั้น รูปแบบ Canonical 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 ของภาษาที่ยอมรับ

ความสนใจด้านความสัมพันธ์

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

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

object (FieldMetadata)

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

value

string

ประเภทความสัมพันธ์ที่ผู้ใช้กําลังมองหา ค่านี้อาจเป็นค่าที่กําหนดเองหรือค่าที่กําหนดไว้ล่วงหน้าอย่างใดอย่างหนึ่งต่อไปนี้

  • friend
  • date
  • relationship
  • networking
formattedValue

string

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

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

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

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

เป็นจริงหาก ที่พักเป็นที่พํานักปัจจุบันของบุคคล เป็นเท็จ หากที่พักเป็นที่พํานักในอดีต

ที่อยู่ Sip

ที่อยู่ 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

ผู้ใช้กําหนด

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

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

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