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 להורדה של הבייטים של התמונות בתשובה עם התמונה.
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.