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.

פרמטרים של שאילתה

פרמטרים
photoIds[]

string

חובה. המזהים של Photos. בבקשות HTTP GET, פרמטר השאילתה של כתובת ה-URL צריך להיות photoIds=<id1>&photoIds=<id2>&....
view

enum (PhotoView)

חובה. מציינת אם כתובת URL להורדה של הבייטים של התמונות תוחזר בתגובה ל-Photos.
languageCode

string

אפשרות. קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא צוין קוד שפה, ייעשה שימוש בהעדפת השפה של המשתמש עבור שירותי Google.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

תגובה לקבוצה של Photos.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
שדות
results[]

object (PhotoResponse)

רשימת תוצאות לכל בקשה בנפרד עבור Photo, באותו סדר שבו מוצגות הבקשות ב-photos.batchGet.

היקפי הרשאות

נדרש היקף OAuth הבא:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.