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.

גוף הבקשה

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

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

object

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

object (Photo)

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

string (FieldMask format)

חובה. הוספת מסכה שמזהה שדות במטא-נתונים של התמונות שיש לעדכן. אם לא קיימים, המטא-נתונים הישנים מסוג 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.