Method: documents.create

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

Returns the created document.

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

Output only. The ID of the document.

title

string

The title of the document.

tabs[]

object ( Tab )

Output only. Tabs that are part of a document.

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

revisionId

string

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

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

suggestionsViewMode

enum ( SuggestionsViewMode )

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

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

commentsViewMode

enum ( CommentsViewMode )

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

comments[]

object ( CommentThread )

Output only. The comments associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as COMMENTS_VIEW_MODE_INCLUDED ).

suggestions[]

object ( SuggestionThread )

Output only. The suggestions associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as COMMENTS_VIEW_MODE_INCLUDED ).

body

object ( Body )

Output only. The main body of the document.

লিগ্যাসি ফিল্ড: এর পরিবর্তে, 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 )

Output only. The style of the document.

Legacy field: Instead, use Document.tabs.documentTab.documentStyle , which exposes the actual document content from all tabs when the includeTabsContent parameter is set to true . If false or unset, this field contains information about the first tab in the document.

suggestedDocumentStyleChanges

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

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

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

namedStyles

object ( NamedStyles )

Output only. The named styles of the document.

লিগ্যাসি ফিল্ড: এর পরিবর্তে, 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 ))

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

Legacy field: Instead, use Document.tabs.documentTab.namedRanges , which exposes the actual document content from all tabs when the includeTabsContent parameter is set to true . If false or unset, this field contains information about the first tab in the document.

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

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