Package google.bytestream

সূচক

• ByteStream (ইন্টারফেস)
• RestByteStream (ইন্টারফেস)
• Media (বার্তা)
• UpdateMediaRequest (বার্তা)
• WriteRequest (বার্তা)
• WriteResponse (বার্তা)

বাইটস্ট্রিম

বাইট স্ট্রিম এপিআই একটি ক্লায়েন্টকে রিসোর্স থেকে বাইটের একটি স্ট্রিম পড়তে এবং লিখতে সক্ষম করে। সংস্থানগুলির নাম রয়েছে এবং এই নামগুলি নীচের API কলগুলিতে সরবরাহ করা হয়েছে যে সংস্থানগুলি থেকে পড়া বা লেখা হচ্ছে তা সনাক্ত করতে৷

বাইট স্ট্রিম API-এর সমস্ত বাস্তবায়ন এখানে সংজ্ঞায়িত ইন্টারফেস রপ্তানি করে:

• Read() : একটি সম্পদের বিষয়বস্তু পড়ে।

• Write() : একটি সম্পদের বিষয়বস্তু লেখে। ক্লায়েন্ট একই রিসোর্স দিয়ে একাধিকবার Write() কল করতে পারে এবং QueryWriteStatus() কল করে লেখার স্থিতি পরীক্ষা করতে পারে।

ByteStream API রিসোর্সের সাথে যুক্ত কোনো মেটাডেটা অ্যাক্সেস/পরিবর্তন করার কোনো সরাসরি উপায় প্রদান করে না।

পরিষেবার দ্বারা প্রত্যাবর্তিত ত্রুটিগুলি Google ক্যানোনিকাল ত্রুটি স্থানের মধ্যে রয়েছে৷

লিখুন

rpc Write( WriteRequest ) returns ( WriteResponse ) Write() একটি রিসোর্সের বিষয়বস্তু বাইটের ক্রম হিসাবে পাঠাতে ব্যবহৃত হয়। বাইটগুলি একটি ক্লায়েন্ট-সাইড স্ট্রিমিং RPC-এর অনুরোধ প্রোটোগুলির একটি ক্রমানুসারে পাঠানো হয়। একটি Write() ক্রিয়া পুনরায় শুরু করা যায়। Write() এর সময় যদি কোনো ত্রুটি থাকে বা সংযোগ বিচ্ছিন্ন হয়ে যায়, তাহলে ক্লায়েন্টকে QueryWriteStatus() কল করে Write() এর স্থিতি পরীক্ষা করতে হবে এবং ফিরে আসা committed_size থেকে লেখা চালিয়ে যেতে হবে। এটি ক্লায়েন্টের পূর্বে পাঠানো ডেটার পরিমাণের চেয়ে কম হতে পারে। পূর্বে লিখিত এবং চূড়ান্ত করা একটি সংস্থান নামের উপর Write() কল করা একটি ত্রুটির কারণ হতে পারে, অন্তর্নিহিত পরিষেবাটি পূর্বে লিখিত সংস্থানগুলির অতিরিক্ত লেখার অনুমতি দেয় কিনা তার উপর নির্ভর করে। যখন ক্লায়েন্ট অনুরোধ চ্যানেল বন্ধ করে, পরিষেবাটি একটি WriteResponse দিয়ে প্রতিক্রিয়া জানাবে। যতক্ষণ না ক্লায়েন্ট একটি WriteRequest না পাঠায় ততক্ষণ পর্যন্ত পরিষেবাটি রিসোর্সটিকে complete দেখতে পাবে না যতক্ষণ না finish_write সেট করে true । finish_write true সেট করে একটি অনুরোধ পাঠানোর পরে একটি স্ট্রীমে যেকোনও অনুরোধ পাঠানো একটি ত্রুটির কারণ হবে৷ পরিষেবাটি কতটা ডেটা কমিট করতে সক্ষম হয়েছিল এবং পরিষেবাটি সংস্থানটিকে complete হিসাবে দেখছে কিনা তা নির্ধারণ করতে ক্লায়েন্টের প্রাপ্ত WriteResponse পরীক্ষা করা উচিত । অনুমোদনের সুযোগ নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন: https://www.googleapis.com/auth/plus.business.manage https://www.googleapis.com/auth/business.manage আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

RestByteStream

আপডেট মিডিয়া
rpc UpdateMedia( UpdateMediaRequest ) returns ( Media ) মিডিয়া আপলোড করে। আপলোড URI /upload/v1/media/{+name} তে সমর্থিত। অনুমোদনের সুযোগ নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন: https://www.googleapis.com/auth/plus.business.manage https://www.googleapis.com/auth/business.manage আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

মিডিয়া

মিডিয়া সম্পদ।

ক্ষেত্র
resource_name	string মিডিয়া সম্পদের নাম।

আপডেট মিডিয়া অনুরোধ

মিডিয়া আপলোড করার জন্য অনুরোধ বার্তা.

ক্ষেত্র
resource_name	string যে মিডিয়ার নাম ডাউনলোড করা হচ্ছে। ReadRequest.resource_name দেখুন।
media	Media আপলোড করা হচ্ছে মিডিয়ার প্রতিনিধিত্ব।

অনুরোধ লিখুন

ByteStream.Write-এর জন্য বস্তুর অনুরোধ করুন।

ক্ষেত্র
resource_name	string সম্পদের নাম লিখতে হবে। এটি অবশ্যই প্রতিটি Write() অ্যাকশনের প্রথম WriteRequest এ সেট করতে হবে। যদি এটি পরবর্তী কলগুলিতে সেট করা থাকে তবে এটি অবশ্যই প্রথম অনুরোধের মানের সাথে মেলে।
write_offset	int64 রিসোর্সের শুরু থেকে অফসেট যেখানে ডেটা লেখা উচিত। এটি সমস্ত WriteRequest s-এ প্রয়োজনীয়। একটি Write() কর্মের প্রথম WriteRequest এ, এটি Write() কলের জন্য প্রাথমিক অফসেট নির্দেশ করে। QueryWriteStatus() এ একটি কল যেটি ফিরে আসবে সেটির মান অবশ্যই committed_size সমান হতে হবে। পরবর্তী কলগুলিতে, এই মানটি অবশ্যই সেট করতে হবে এবং প্রথম write_offset যোগফল এবং এই স্ট্রীমে আগে পাঠানো সমস্ত data বান্ডেলের আকারের সমান হতে হবে । একটি ভুল মান একটি ত্রুটির কারণ হবে.
finish_write	bool true হলে, এটি নির্দেশ করে যে লেখাটি সম্পূর্ণ। যেকোন WriteRequest s পরবর্তীতে পাঠালে একটি ত্রুটি ঘটবে যেখানে finish_write true ।
data	bytes সম্পদের জন্য ডেটার একটি অংশ। ক্লায়েন্ট যে কোনো প্রদত্ত WriteRequest এর জন্য data খালি রাখতে পারে । এটি ক্লায়েন্টকে পরিষেবাটিকে জানাতে সক্ষম করে যে অনুরোধটি এখনও লাইভ রয়েছে যখন এটি আরও ডেটা জেনারেট করার জন্য একটি অপারেশন চালাচ্ছে।

প্রতিক্রিয়া লিখুন

ByteStream.Write এর জন্য রেসপন্স অবজেক্ট।

ক্ষেত্র
committed_size	int64 প্রদত্ত সংস্থানের জন্য প্রসেস করা বাইটের সংখ্যা।