Method: documents.create

অনুরোধে প্রদত্ত শিরোনাম ব্যবহার করে একটি খালি ডকুমেন্ট তৈরি করে। অনুরোধের অন্যান্য ক্ষেত্র, প্রদত্ত যেকোনো বিষয়বস্তু সহ, উপেক্ষা করা হয়।

তৈরি করা ডকুমেন্টটি ফেরত দেয়।

HTTP অনুরোধ

POST https://docs.googleapis.com/v1/documents

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
ক্ষেত্র
documentId

string

শুধুমাত্র আউটপুট। ডকুমেন্টটির আইডি।

title

string

নথিটির শিরোনাম।

tabs[]

object ( Tab )

ট্যাবগুলো কোনো ডকুমেন্টের অংশ।

ট্যাবের মধ্যে চাইল্ড ট্যাব থাকতে পারে, অর্থাৎ একটি ট্যাবের ভেতরে আরেকটি ট্যাব থাকতে পারে। চাইল্ড ট্যাবগুলোকে Tab.childTabs ফিল্ড দ্বারা প্রকাশ করা হয়।

revisionId

string

শুধুমাত্র আউটপুট। ডকুমেন্টটির রিভিশন আইডি। আপডেট অনুরোধে এটি ব্যবহার করে নির্দিষ্ট করা যায় যে, ডকুমেন্টের কোন রিভিশনে আপডেট প্রয়োগ করতে হবে এবং সেই রিভিশনের পর ডকুমেন্টটি সম্পাদিত হয়ে থাকলে অনুরোধটি কীভাবে কাজ করবে। শুধুমাত্র তখনই এটি পূরণ করা হয়, যখন ব্যবহারকারীর ডকুমেন্টটি সম্পাদনা করার অ্যাক্সেস থাকে।

রিভিশন আইডি কোনো ক্রমিক সংখ্যা নয়, বরং এটি একটি অস্বচ্ছ স্ট্রিং। সময়ের সাথে সাথে রিভিশন আইডির ফরম্যাট পরিবর্তিত হতে পারে। ফেরত আসা রিভিশন আইডি শুধুমাত্র ফেরত দেওয়ার পর ২৪ ঘণ্টার জন্য বৈধ থাকার নিশ্চয়তা দেয় এবং এটি ব্যবহারকারীদের মধ্যে শেয়ার করা যায় না। যদি দুটি কলের মধ্যে রিভিশন আইডি অপরিবর্তিত থাকে, তাহলে ডকুমেন্টটি পরিবর্তিত হয়নি। এর বিপরীতে, একটি পরিবর্তিত আইডি (একই ডকুমেন্ট এবং ব্যবহারকারীর জন্য) সাধারণত বোঝায় যে ডকুমেন্টটি আপডেট করা হয়েছে। তবে, আইডি ফরম্যাট পরিবর্তনের মতো অভ্যন্তরীণ কারণের জন্যও আইডি পরিবর্তিত হতে পারে।

suggestionsViewMode

enum ( SuggestionsViewMode )

শুধুমাত্র আউটপুট। ডকুমেন্টটিতে সাজেশন ভিউ মোড প্রয়োগ করা হয়েছে।

দ্রষ্টব্য: কোনো ডকুমেন্ট সম্পাদনা করার সময়, পরিবর্তনগুলি অবশ্যই SUGGESTIONS_INLINE যুক্ত ডকুমেন্টের উপর ভিত্তি করে করতে হবে।

commentsViewMode

enum ( CommentsViewMode )

শুধুমাত্র আউটপুট। ডকুমেন্টটিতে মন্তব্য দেখার মোড প্রয়োগ করা হয়েছে।

comments[]

object ( CommentThread )

শুধুমাত্র আউটপুট। ডকুমেন্টটির সাথে যুক্ত মন্তব্যসমূহ। এটি কেবল তখনই পূরণ করা হয়, যখন commentsViewMode প্যারামিটারটি মন্তব্য আবশ্যক হিসেবে সেট করা থাকে (যেমন COMMENTS_VIEW_MODE_INCLUDED )।

suggestions[]

object ( SuggestionThread )

শুধুমাত্র আউটপুট। ডকুমেন্টটির সাথে সম্পর্কিত সাজেশনগুলো। এটি কেবল তখনই প্রদর্শিত হবে, যখন commentsViewMode প্যারামিটারটি কমেন্ট আবশ্যক হিসেবে সেট করা থাকে (যেমন COMMENTS_VIEW_MODE_INCLUDED )।

body

object ( Body )

শুধুমাত্র আউটপুট। ডকুমেন্টের মূল অংশ।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.body ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

headers

map (key: string, value: object ( Header ))

শুধুমাত্র আউটপুট। ডকুমেন্টের হেডারগুলো হেডার আইডি দ্বারা চিহ্নিত করা হয়েছে।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.headers ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাবের প্রকৃত ডকুমেন্ট কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

footers

map (key: string, value: object ( Footer ))

শুধুমাত্র আউটপুট। ডকুমেন্টের ফুটারগুলো, ফুটার আইডি দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.footers ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাব সম্পর্কিত তথ্য থাকে।

footnotes

map (key: string, value: object ( Footnote ))

শুধুমাত্র আউটপুট। ডকুমেন্টের পাদটীকাগুলো, পাদটীকা আইডি দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.footnotes ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত বিষয়বস্তু প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

documentStyle

object ( DocumentStyle )

শুধুমাত্র আউটপুট। ডকুমেন্টটির স্টাইল।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.documentStyle ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

suggestedDocumentStyleChanges

map (key: string, value: object ( SuggestedDocumentStyle ))

শুধুমাত্র আউটপুট। সাজেশন আইডি দ্বারা চিহ্নিত, ডকুমেন্টের স্টাইলে প্রস্তাবিত পরিবর্তনগুলো।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.suggestedDocumentStyleChanges ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

namedStyles

object ( NamedStyles )

শুধুমাত্র আউটপুট। ডকুমেন্টটির নামযুক্ত স্টাইলসমূহ।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.namedStyles ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাব সম্পর্কিত তথ্য থাকে।

suggestedNamedStylesChanges

map (key: string, value: object ( SuggestedNamedStyles ))

শুধুমাত্র আউটপুট। সাজেশন আইডি দ্বারা চিহ্নিত, ডকুমেন্টের নামযুক্ত স্টাইলগুলিতে প্রস্তাবিত পরিবর্তনসমূহ।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.suggestedNamedStylesChanges ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

lists

map (key: string, value: object ( List ))

শুধুমাত্র আউটপুট। ডকুমেন্টের তালিকাগুলো, যা তালিকা আইডি দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.lists ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত বিষয়বস্তু প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

namedRanges

map (key: string, value: object ( NamedRanges ))

শুধুমাত্র আউটপুট। ডকুমেন্টের নামযুক্ত রেঞ্জগুলো, যা নাম দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.namedRanges ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

inlineObjects

map (key: string, value: object ( InlineObject ))

শুধুমাত্র আউটপুট। ডকুমেন্টের ইনলাইন অবজেক্টগুলো, যা অবজেক্ট আইডি দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.inlineObjects ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

positionedObjects

map (key: string, value: object ( PositionedObject ))

শুধুমাত্র আউটপুট। ডকুমেন্টে অবস্থিত অবজেক্টগুলো, যা অবজেক্ট আইডি দ্বারা চিহ্নিত।

লিগ্যাসি ফিল্ড: এর পরিবর্তে, Document.tabs.documentTab.positionedObjects ব্যবহার করুন, যা includeTabsContent প্যারামিটারটি true সেট করা থাকলে সমস্ত ট্যাব থেকে ডকুমেন্টের প্রকৃত কন্টেন্ট প্রকাশ করে। যদি false বা সেট করা না থাকে, তাহলে এই ফিল্ডটিতে ডকুমেন্টের প্রথম ট্যাবের তথ্য থাকে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Document এর একটি নতুন তৈরি হওয়া ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।