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.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
הערה: אם השדה updateMask מכיל שדות חוזרים, כל הערכים של הערכים החוזרים מוחלפים בתוכן החדש. לדוגמה, אם updateMask מכיל את connections ו-UpdatePhotoRequest.photo.connections ריק, כל החיבורים יוסרו.
|
גוף התשובה
תגובה לעדכון בכמות גדולה של מטא-נתונים מסוג Photos או יותר.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| שדות |
results[] |
object (PhotoResponse)
רשימת תוצאות לכל Photo בנפרד, לפי סדר הבקשה.
|
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/streetviewpublish
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-10 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-09-10 (שעון UTC)."],[[["The API updates metadata of photos, such as pose, connections, and place association, but does not change pixel data."],["Requests are submitted as a batch of up to 20 `UpdatePhotoRequest` messages specifying the photo and fields to update."],["If the `updateMask` is not provided, all fields of the Photo resource will be updated with the values provided in the request."],["When updating `Pose.altitude`, `Pose.latLngPair` must also be specified, or the request will fail."],["This API requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."]]],["This document details the process of updating photo metadata via the `photos:batchUpdate` method. It outlines that you can update fields like pose, place association, and connections, but not photo pixels. The request involves sending `UpdatePhotoRequests` within a `BatchUpdatePhotosRequest` to `POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate`. An `updateMask` specifies which fields to modify. The response contains a list of `PhotoResponse` objects, indicating the success or failure of each photo update. A maximum of 20 `UpdatePhotoRequest` messages are allowed.\n"]]
