Method: photo.update

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

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

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

string

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

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

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.