Method: photos.batchUpdate

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

توجه داشته باشید که اگر photos.batchUpdate با شکست مواجه شود، یا فیلدهای حیاتی از دست رفته‌اند یا خطای احراز هویت وجود دارد. حتی اگر photos.batchUpdate با موفقیت انجام شود، ممکن است عکس‌های تکی در دسته دچار شکست شوند. این شکست‌ها در هر PhotoResponse.status در BatchUpdatePhotosResponse.results مشخص شده‌اند. برای شکست‌های خاصی که ممکن است برای هر عکس رخ دهد، به photo.update مراجعه کنید.

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

تعداد پیام‌های UpdatePhotoRequest در یک BatchUpdatePhotosRequest نباید از 20 بیشتر شود.

نکته: برای به‌روزرسانی Pose.altitude ، باید Pose.latLngPair نیز پر شود. در غیر این صورت، درخواست با شکست مواجه خواهد شد.

درخواست HTTP

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

درخواست بدنه

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

نمایش JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
فیلدها
updatePhotoRequests[]

object

الزامی. فهرست UpdatePhotoRequests .

updatePhotoRequests[].photo

object ( Photo )

الزامی. شیء Photo حاوی فراداده جدید.

updatePhotoRequests[].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 خالی باشد، تمام اتصالات حذف می‌شوند.

بدنه پاسخ

پاسخ به به‌روزرسانی دسته‌ای فراداده‌های یک یا چند Photos .

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

نمایش JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
فیلدها
results[]

object ( PhotoResponse )

فهرست نتایج برای هر Photo جداگانه، به همان ترتیب درخواست، به‌روزرسانی شد.

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

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

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

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