Method: photos.batchUpdate

Photos का मेटाडेटा अपडेट करता है, जैसे कि आसन, जगह की जानकारी, कनेक्शन वगैरह. फ़ोटो के पिक्सल बदलने की सुविधा नहीं है.

ध्यान दें कि अगर photos.batchUpdate काम नहीं करता, तो ज़रूरी फ़ील्ड मौजूद नहीं हैं या पुष्टि करने में कोई गड़बड़ी हुई है. photos.batchUpdate के सफल होने पर भी, हो सकता है कि बैच की अलग-अलग फ़ोटो में कुछ गड़बड़ी हो. इन गड़बड़ियों की जानकारी BatchUpdatePhotosResponse.results के हर PhotoResponse.status में दी गई है. हर फ़ोटो में हो सकने वाली खास गड़बड़ियों के लिए photo.update देखें.

सिर्फ़ updateMask फ़ील्ड में दिए गए फ़ील्ड का इस्तेमाल किया जाता है. अगर updateMask मौजूद नहीं है, तो अपडेट सभी फ़ील्ड पर लागू होता है.

BatchUpdatePhotosRequest में UpdatePhotoRequest मैसेज की संख्या 20 से ज़्यादा नहीं होनी चाहिए.

ध्यान दें: Pose.altitude को अपडेट करने के लिए, Pose.latLngPair को भी भरना होगा. ऐसा न करने पर, अनुरोध स्वीकार नहीं किया जाएगा.

एचटीटीपी अनुरोध

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{
  "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 के मेटाडेटा के बैच अपडेट का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
फ़ील्ड
results[]

object (PhotoResponse)

हर Photo के लिए, नतीजों की सूची को उसी क्रम में अपडेट किया जाता है जिस क्रम में अनुरोध किया गया था.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.