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)

مطلوبة. وحدات البايت غير المعدّلة للصور

سلسلة بترميز base64.

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)

الشخص الذي تم تعديله، في حال ضبط userFields في UpdateContactImageRequest، وإلا لن يتم ضبط هذا الإعداد.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.