Method: photo.update

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

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

השיטה הזו מחזירה את קודי השגיאה הבאים:

בקשת HTTP

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

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

פרמטרים של נתיב

פרמטרים
photo.photoId.id

string

מזהה ייחודי של תמונה.

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

פרמטרים
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 ריק, כל החיבורים יוסרו.

גוף הבקשה

גוף הבקשה מכיל מופע של Photo.

גוף התשובה

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

היקפי הרשאה

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

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

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