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 از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

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

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