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 ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

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

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

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

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

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

object (PhotoResponse)

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

अनुमति पाने के लिंक

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

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

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