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.