עדכון המטא-נתונים של 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 ( |
שדות | |
---|---|
updatePhotoRequests[] |
חובה. רשימה של |
updatePhotoRequests[].photo |
חובה. אובייקט |
updatePhotoRequests[].updateMask |
חובה. מסכה שמזהה שדות במטא-נתונים של התמונה לצורך עדכון. אם אין, המטא-נתונים הישנים של השדות הבאים חוקיים:
|
גוף התשובה
תגובה לעדכון בכמות גדולה של מטא-נתונים של Photos
או יותר.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"results": [
{
object ( |
שדות | |
---|---|
results[] |
רשימת תוצאות לכל |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/streetviewpublish
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.