- HTTP অনুরোধ
- পাথ প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- অনুরোধ
- AllTextRequest প্রতিস্থাপন করুন
- সাবস্ট্রিং ম্যাচের মানদণ্ড
- ট্যাব মানদণ্ড
- InsertTextRequest
- অবস্থান
- EndOfSegmentLocation
- UpdateTextStyleRequest
- ParagraphBulletsRequest তৈরি করুন
- বুলেটগ্লাইফপ্রিসেট
- অনুচ্ছেদ মুছুন বুলেট অনুরোধ
- NamedRangeRequest তৈরি করুন
- নামযুক্ত রেঞ্জের অনুরোধ মুছুন
- অনুচ্ছেদশৈলীর অনুরোধ আপডেট করুন
- DeleteContentRangeRequest
- InsertInlineImageRequest
- InsertTableRequest
- InsertTableRowRequest
- টেবিল সেল অবস্থান
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- InsertPageBreakRequest
- ডিলিট পজিশন করা অবজেক্ট রিকোয়েস্ট
- UpdateTableColumnPropertiesRequest
- UpdateTableCellStyleRequest
- টেবিল রেঞ্জ
- UpdateTableRowStyleRequest
- প্রতিস্থাপন চিত্র অনুরোধ
- ইমেজ রিপ্লেস মেথড
- UpdateDocumentStyleRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- HeaderRequest তৈরি করুন
- হেডারফুটার টাইপ
- ফুটারের অনুরোধ তৈরি করুন
- পাদটীকা অনুরোধ তৈরি করুন
- ReplaceNamedRangeContentRequest
- UpdateSectionStyleRequest
- ইনসার্ট সেকশনব্রেক রিকোয়েস্ট
- হেডার রিকোয়েস্ট মুছুন
- ডিলিটফুটার রিকোয়েস্ট
- PinTableHeaderRowsRequest
- WriteControl
- প্রতিক্রিয়া
- AllTextResponse প্রতিস্থাপন করুন
- NamedRangeResponse তৈরি করুন
- InsertInlineImageResponse
- InsertInlineSheetsChartResponse
- হেডার রেসপন্স তৈরি করুন
- ফুটার প্রতিক্রিয়া তৈরি করুন
- ফুটনোট প্রতিক্রিয়া তৈরি করুন
- এটা চেষ্টা করুন!
নথিতে এক বা একাধিক আপডেট প্রয়োগ করে।
প্রতিটি request
প্রয়োগ করার আগে যাচাই করা হয়। যদি কোনো অনুরোধ বৈধ না হয়, তাহলে সম্পূর্ণ অনুরোধ ব্যর্থ হবে এবং কিছুই প্রয়োগ করা হবে না।
কিছু অনুরোধের replies
আছে যেগুলি কীভাবে প্রয়োগ করা হয় সে সম্পর্কে আপনাকে কিছু তথ্য দিতে। অন্যান্য অনুরোধের তথ্য ফেরত দেওয়ার প্রয়োজন নেই; এই প্রতিটি একটি খালি উত্তর ফেরত. উত্তরের ক্রম অনুরোধের সাথে মেলে।
উদাহরণস্বরূপ, ধরুন আপনি চারটি আপডেট সহ batchUpdate কল করেন এবং শুধুমাত্র তৃতীয়টি তথ্য প্রদান করে। প্রতিক্রিয়াটির দুটি খালি উত্তর থাকবে, তৃতীয় অনুরোধের উত্তর এবং সেই ক্রমে আরেকটি খালি উত্তর।
যেহেতু অন্যান্য ব্যবহারকারীরা দস্তাবেজ সম্পাদনা করতে পারে, তাই নথিটি আপনার পরিবর্তনগুলিকে সঠিকভাবে প্রতিফলিত নাও করতে পারে: আপনার পরিবর্তনগুলি সহযোগী পরিবর্তনের ক্ষেত্রে পরিবর্তিত হতে পারে৷ যদি কোন সহযোগী না থাকে, তাহলে নথিতে আপনার পরিবর্তনগুলি প্রতিফলিত হওয়া উচিত। যাই হোক না কেন, আপনার অনুরোধের আপডেটগুলি পরমাণুভাবে একসাথে প্রয়োগ করার নিশ্চয়তা রয়েছে৷
HTTP অনুরোধ
POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
documentId | আপডেট করার জন্য নথির আইডি। |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "requests": [ { object ( |
ক্ষেত্র | |
---|---|
requests[] | নথিতে আবেদন করার জন্য আপডেটের একটি তালিকা। |
writeControl | লেখার অনুরোধ কিভাবে কার্যকর করা হয় তার উপর নিয়ন্ত্রণ প্রদান করে। |
প্রতিক্রিয়া শরীর
একটি documents.batchUpdate
অনুরোধ থেকে প্রতিক্রিয়া বার্তা.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "documentId": string, "replies": [ { object ( |
ক্ষেত্র | |
---|---|
documentId | নথির আইডি যেখানে আপডেটগুলি প্রয়োগ করা হয়েছে৷ |
replies[] | আপডেটের উত্তর। এই মানচিত্র 1:1 আপডেট সহ, যদিও কিছু অনুরোধের উত্তর খালি হতে পারে। |
writeControl | অনুরোধ প্রয়োগ করার পরে আপডেট করা লেখা নিয়ন্ত্রণ। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/documents
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।
WriteControl
লেখার অনুরোধ কিভাবে কার্যকর করা হয় তার উপর নিয়ন্ত্রণ প্রদান করে।
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ক্ষেত্র | |
---|---|
ইউনিয়ন ক্ষেত্র control । নথির সংশোধন নির্ধারণ করে যেটিকে লিখতে হবে এবং অনুরোধটি কীভাবে আচরণ করা উচিত যদি সেই সংশোধনটি নথির বর্তমান সংশোধন না হয়। যদি কোনো ক্ষেত্র নির্দিষ্ট করা না থাকে, আপডেটগুলি সর্বশেষ সংশোধনে প্রয়োগ করা হয়। control নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
requiredRevisionId | যে নথিতে লেখার অনুরোধটি প্রয়োগ করা হয়েছে তার ঐচ্ছিক যখন একটি প্রয়োজনীয় পুনর্বিবেচনা আইডি একটি প্রতিক্রিয়াতে ফেরত দেওয়া হয়, তখন অনুরোধটি প্রয়োগ করার পরে এটি নথির সংশোধন আইডি নির্দেশ করে৷ |
targetRevisionId | যে নথিতে লেখার অনুরোধ প্রয়োগ করা হয়েছে তার ঐচ্ছিক লক্ষ্য এপিআই ব্যবহার করে ডকুমেন্টটি পড়ার পরে যদি সহযোগী পরিবর্তনগুলি ঘটে থাকে, তাহলে এই লেখার অনুরোধ দ্বারা উত্পাদিত পরিবর্তনগুলি সহযোগী পরিবর্তনের বিরুদ্ধে প্রয়োগ করা হয়। এর ফলে ডকুমেন্টের একটি নতুন পুনর্বিবেচনা হয় যা সহযোগী পরিবর্তন এবং অনুরোধের পরিবর্তন উভয়ই অন্তর্ভুক্ত করে, ডক্স সার্ভার বিরোধপূর্ণ পরিবর্তনগুলি সমাধান করে। টার্গেট রিভিশন আইডি ব্যবহার করার সময়, API ক্লায়েন্টকে ডকুমেন্টের অন্য সহযোগী হিসেবে ভাবা যেতে পারে। লক্ষ্য সংশোধন আইডি শুধুমাত্র একটি নথির সাম্প্রতিক সংস্করণ লিখতে ব্যবহার করা যেতে পারে। যদি টার্গেট রিভিশন সাম্প্রতিক রিভিশন থেকে অনেক পিছিয়ে থাকে, তাহলে রিকোয়েস্ট প্রসেস করা হয় না এবং একটি 400 খারাপ রিকোয়েস্ট এরর রিটার্ন করে। নথির সর্বশেষ সংস্করণ পুনরুদ্ধার করার পরে অনুরোধটি আবার চেষ্টা করা উচিত। সাধারণত একটি রিভিশন আইডি এটি পড়ার পরে কয়েক মিনিটের জন্য টার্গেট রিভিশন হিসাবে ব্যবহারের জন্য বৈধ থাকে, তবে ঘন ঘন এডিট করা নথিগুলির জন্য এই উইন্ডোটি ছোট হতে পারে। |