Method: photos.batchGet

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

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

درخواست HTTP

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

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

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

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

string

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

view

enum ( PhotoView )

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

languageCode

string

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

درخواست بدن

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

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

object ( PhotoResponse )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.