Method: people.updateContactPhoto

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

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

คำขอ HTTP

PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
resourceName

string

ต้องระบุ ชื่อทรัพยากรบุคคล

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
ช่อง
photoBytes

string (bytes format)

ต้องระบุ ไบต์ของรูปภาพดิบ

สตริงที่เข้ารหัสฐาน 64

personFields

string (FieldMask format)

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

  • ที่อยู่
  • ageRanges
  • ชีวประวัติ
  • วันเกิด
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • กิจกรรม
  • externalIds
  • เพศ
  • imClients
  • ความสนใจ
  • locales
  • สถานที่ตั้ง
  • ของช่อง
  • ข้อมูลเมตา
  • miscKeywords
  • names
  • ชื่อเล่น
  • อาชีพ
  • organizations
  • phoneNumbers
  • ภาพถ่าย
  • ความสัมพันธ์
  • sipAddresses
  • ทักษะ
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผล ค่าเริ่มต้นจะเป็น READ_SOURCE_TYPE_CONTACT และ READ_SOURCE_TYPE_PROFILE หากไม่ได้ตั้งค่าไว้

เนื้อหาการตอบกลับ

การตอบกลับสำหรับการอัปเดตรูปภาพของรายชื่อติดต่อ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "person": {
    object (Person)
  }
}
ช่อง
person

object (Person)

บุคคลที่อัปเดต หากมีการตั้งค่า personFields ใน UpdateContactPhotoRequest มิเช่นนั้นจะไม่มีการตั้งค่า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/contacts

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์