Method: photos.batchUpdate

עדכון המטא-נתונים של Photos, כמו תנוחה, שיוך למקום, קשרים וכו'. אין תמיכה בשינוי הפיקסלים של התמונות.

שימו לב: אם photos.batchUpdate נכשל, יכול להיות שחסרים שדות קריטיים או שיש שגיאת אימות. גם אם photos.batchUpdate מצליח, יכול להיות שיהיו כשלים בתמונות ספציפיות בחבילה. הכשלים האלה מפורטים בכל PhotoResponse.status ב-BatchUpdatePhotosResponse.results. במאמר photo.update מפורטות שגיאות ספציפיות שיכולות להתרחש לגבי כל תמונה.

רק השדות שצוינו בשדה updateMask נמצאים בשימוש. אם התג updateMask לא מופיע, העדכון חל על כל השדות.

מספר ההודעות UpdatePhotoRequest בBatchUpdatePhotosRequest לא יכול לעלות על 20.

הערה: כדי לעדכן את Pose.altitude, צריך למלא גם את Pose.latLngPair. אחרת, הבקשה תיכשל.

בקשת HTTP

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

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

object

חובה. רשימה של UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

חובה. אובייקט Photo שמכיל את המטא-נתונים החדשים.
updatePhotoRequests[].updateMask

string (FieldMask format)

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

השדות הבאים הם חוקיים:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

הערה: אם updateMask מכיל שדות חוזרים, כל קבוצת הערכים החוזרים מוחלפת בתוכן החדש. לדוגמה, אם updateMask מכיל את connections ו-UpdatePhotoRequest.photo.connections ריק, כל החיבורים יוסרו.

גוף התשובה

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

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

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

object (PhotoResponse)

רשימת התוצאות של כל Photo מתעדכנת באותו סדר של הבקשה.

היקפי הרשאה

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

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

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