संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
यह संसाधन एक लंबे समय तक चलने वाले ऑपरेशन का प्रतिनिधित्व करता है जो एक नेटवर्क एपीआई कॉल का परिणाम है।
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 निम्न में से केवल एक ही हो सकता है:
विफलता या रद्द होने की स्थिति में ऑपरेशन का त्रुटि परिणाम।
response
object
सफलता के मामले में ऑपरेशन की सामान्य प्रतिक्रिया। मूल विधि जैसे सफलता पर कोई डेटा, देता है, तो Delete , प्रतिक्रिया है google.protobuf.Empty । मूल विधि मानक है Get / Create / Update , प्रतिक्रिया संसाधन होना चाहिए। अन्य तरीकों के लिए, प्रतिक्रिया प्रकार होना चाहिए XxxResponse , जहां Xxx मूल विधि का नाम है। उदाहरण के लिए, यदि मूल विधि नाम है TakeSnapshot() , अनुमानित प्रतिक्रिया प्रकार है TakeSnapshotResponse ।
एक वस्तु जिसमें एक मनमाना प्रकार के क्षेत्र होते हैं। एक अतिरिक्त क्षेत्र "@type" यूआरआई प्रकार की पहचान करने में शामिल है। उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" } ।