Method: photo.update

ابرداده‌های یک Photo ، مانند ژست، ارتباط مکانی، اتصالات و غیره را به‌روزرسانی می‌کند. تغییر پیکسل‌های یک عکس پشتیبانی نمی‌شود.

فقط فیلدهای مشخص شده در فیلد updateMask استفاده می‌شوند. اگر updateMask وجود نداشته باشد، به‌روزرسانی برای همه فیلدها اعمال می‌شود.

این متد کدهای خطای زیر را برمی‌گرداند:

درخواست HTTP

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
photo.photoId.id

string

یک شناسه منحصر به فرد برای یک عکس.

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

پارامترها
updateMask

string ( FieldMask format)

الزامی. ماسکی که فیلدهای مربوط به فراداده‌های عکس را برای به‌روزرسانی مشخص می‌کند. در صورت عدم وجود، فراداده‌های Photo قدیمی به‌طور کامل با فراداده‌های Photo جدید در این درخواست جایگزین می‌شوند. در صورت مشخص شدن فیلدهای نامعتبر، به‌روزرسانی با شکست مواجه می‌شود. می‌توان چندین فیلد را در یک لیست جدا شده با کاما مشخص کرد.

فیلدهای زیر معتبر هستند:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

نکته: وقتی updateMask شامل فیلدهای تکراری باشد، کل مجموعه مقادیر تکراری با محتوای جدید جایگزین می‌شوند. برای مثال، اگر updateMask شامل connections باشد و UpdatePhotoRequest.photo.connections خالی باشد، تمام اتصالات حذف می‌شوند.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Photo است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Photo است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .