Method: photos.batchGet

ابرداده‌های دسته Photo مشخص شده را دریافت می‌کند.

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

درخواست HTTP

GET https://streetviewpublish.googleapis.com/v1/photos:batchGet

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

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

پارامترها
photoIds[]

string

الزامی. شناسه Photos . برای درخواست‌های HTTP GET، پارامتر کوئری URL باید photoIds=<id1>&photoIds=<id2>&... باشد.

view

enum ( PhotoView )

الزامی. مشخص می‌کند که آیا باید در پاسخ Photo، یک URL دانلود برای بایت‌های عکس برگردانده شود یا خیر.

languageCode

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. اگر languageCode مشخص نشده باشد، از ترجیح زبان کاربر برای سرویس‌های گوگل استفاده می‌شود.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ به دریافت دسته‌ای Photos .

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

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

object ( PhotoResponse )

فهرست نتایج برای هر Photo درخواستی، به همان ترتیب درخواست‌های موجود در photos.batchGet .

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

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

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

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