Method: photos.list

רשימה של כל Photos ששייכים למשתמש.

הערה: תמונות שנוצרו לאחרונה ועדיין נמצאות בתהליך אינדוקס לא מוחזרות בתשובה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
view

enum (PhotoView)

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

integer

אופציונלי. המספר המקסימלי של תמונות שיוחזרו. הערך של pageSize לא יכול להיות שלילי. אם הערך של pageSize הוא אפס או לא מוגדר, המערכת משתמשת בגודל ברירת המחדל של הדף, שהוא 100. מספר התמונות שמוחזרות בתגובה עשוי להיות קטן מ-pageSize אם מספר התמונות ששייכות למשתמש קטן מ-pageSize.
pageToken

string

אופציונלי. הערך nextPageToken שמוחזר מבקשת photos.list קודמת, אם יש כזה.
filter

string

אופציונלי. ביטוי הסינון. לדוגמה: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

הפילטרים הנתמכים הם: placeId, ‏ min_latitude, ‏ max_latitude, ‏ min_longitude, ‏ max_longitude. מידע נוסף זמין בכתובת https://google.aip.dev/160.
languageCode

string

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

גוף הבקשה

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

גוף התשובה

תשובה לרשימת כל התמונות ששייכות למשתמש.

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

ייצוג ב-JSON 
{
  "photos": [
    {
      object (Photo)
    }
  ],
  "nextPageToken": string
}
שדות
photos[]

object (Photo)

רשימת התמונות. השדה pageSize בבקשה קובע את מספר הפריטים שמוחזרים.
nextPageToken

string

אסימון לאחזור של דף התוצאות הבא, או ערך ריק אם אין עוד תוצאות ברשימה.

היקפי הרשאה

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.