Method: photo.update

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

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

این روش کدهای خطای زیر را برمی گرداند:

درخواست HTTP

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

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

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

مولفه های
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 مراجعه کنید.