Operation

এই সংস্থানটি একটি দীর্ঘ-চলমান অপারেশনের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।

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" কোনো URI টাইপ চিহ্নিতকরণের ধারণ করে। উদাহরণ: { "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" কোনো URI টাইপ চিহ্নিতকরণের ধারণ করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।