Method: people.updateContactPhoto

عکس یک مخاطب را به روز کنید.

درخواست های جهش برای همان کاربر باید به صورت متوالی ارسال شوند تا از افزایش تاخیر و خرابی جلوگیری شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
resourceName

string

ضروری. نام منبع شخص

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
زمینه های
photoBytes

string ( bytes format)

ضروری. بایت های عکس خام

رشته ای با کد base64.

personFields

string ( FieldMask format)

اختیاری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلدها بر روی شخص بازگردانده می شوند. چندین فیلد را می توان با جدا کردن آنها با کاما مشخص کرد. اگر تنظیم نشود، پیش‌فرض‌ها خالی می‌شوند، که از دریافت جهش پست صرفنظر می‌کند. مقادیر معتبر عبارتند از:

  • آدرس ها
  • محدوده سنی
  • بیوگرافی ها
  • تولدها
  • calendarUrls
  • کلاینت دیتا
  • عکسهای روی جلد
  • آدرس ایمیل
  • مناسبت ها
  • شناسه های خارجی
  • جنسیت ها
  • imClients
  • منافع
  • مناطق
  • مکان ها
  • عضویت ها
  • فراداده
  • کلمات کلیدی اشتباه
  • نام ها
  • نام مستعار
  • مشاغل
  • سازمان های
  • شماره تلفن ها
  • عکس ها
  • روابط
  • آدرس های sip
  • مهارت ها
  • آدرس های اینترنتی
  • تعریف شده توسط کاربر
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.