Operation

यह संसाधन एक लंबे समय तक चलने वाले ऑपरेशन का प्रतिनिधित्व करता है जो एक नेटवर्क एपीआई कॉल का परिणाम है।

JSON प्रतिनिधित्व
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object(Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
खेत
name

string

सर्वर-असाइन किया गया नाम, जो मूल रूप से इसे वापस करने वाली सेवा के भीतर अद्वितीय है। आप डिफ़ॉल्ट HTTP मानचित्रण, का उपयोग करते हैं name का स्वरूप होना चाहिए operations/some/unique/name

metadata

object

ऑपरेशन से जुड़ा सेवा-विशिष्ट मेटाडेटा। इसमें आमतौर पर प्रगति की जानकारी और सामान्य मेटाडेटा जैसे समय बनाएँ। कुछ सेवाएं ऐसा मेटाडेटा प्रदान नहीं कर सकती हैं। कोई भी तरीका जो लंबे समय से चल रहे ऑपरेशन को लौटाता है, उसे मेटाडेटा प्रकार, यदि कोई हो, का दस्तावेजीकरण करना चाहिए।

एक वस्तु जिसमें एक मनमाना प्रकार के क्षेत्र होते हैं। एक अतिरिक्त क्षेत्र "@type" यूआरआई प्रकार की पहचान करने में शामिल है। उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }

done

boolean

यदि मान false , इसका मतलब है आपरेशन अभी भी प्रगति पर है। अगर true , आपरेशन पूरा हो गया है, और या तो error या response उपलब्ध है।

संघ क्षेत्र result । आपरेशन परिणाम है, जो या तो एक हो सकता है error या एक वैध response । यदि done == false , न तो error है और न ही response निर्धारित है। यदि done == true , वास्तव में से एक error या response निर्धारित है। result निम्न में से केवल एक ही हो सकता है:
error

object( Status )

विफलता या रद्द होने की स्थिति में ऑपरेशन का त्रुटि परिणाम।

response

object

सफलता के मामले में ऑपरेशन की सामान्य प्रतिक्रिया। मूल विधि जैसे सफलता पर कोई डेटा, देता है, तो Delete , प्रतिक्रिया है google.protobuf.Empty । मूल विधि मानक है Get / Create / Update , प्रतिक्रिया संसाधन होना चाहिए। अन्य तरीकों के लिए, प्रतिक्रिया प्रकार होना चाहिए XxxResponse , जहां Xxx मूल विधि का नाम है। उदाहरण के लिए, यदि मूल विधि नाम है TakeSnapshot() , अनुमानित प्रतिक्रिया प्रकार है TakeSnapshotResponse

एक वस्तु जिसमें एक मनमाना प्रकार के क्षेत्र होते हैं। एक अतिरिक्त क्षेत्र "@type" यूआरआई प्रकार की पहचान करने में शामिल है। उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }