Method: photos.list

בתיבת הדו-שיח הזו מפורטים כל Photos ששייכים למשתמש.

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
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. אם לא צוין קוד שפה, המערכת תשתמש בהעדפת השפה של המשתמש עבור שירותי Google.

גוף הבקשה

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

גוף התשובה

תשובה להצגת כל התמונות של משתמש מסוים.

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

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

object (Photo)

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

string

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

היקפי ההרשאות

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

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

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