Method: photo.update

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

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

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

  • google.rpc.Code.PERMISSION_DENIED अगर अनुरोध करने वाले व्यक्ति ने उस फ़ोटो को नहीं बनाया है जिसके लिए अनुरोध किया गया है.
  • google.rpc.Code.INVALID_ARGUMENT अगर अनुरोध गलत तरीके से किया गया हो.
  • google.rpc.Code.NOT_FOUND अगर अनुरोध की गई फ़ोटो मौजूद नहीं है.
  • अगर अनुरोध किया गया Photo अब भी इंडेक्स किया जा रहा है, तो google.rpc.Code.UNAVAILABLE.

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

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

यह यूआरएल, 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 Overview देखें.