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.