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),
  "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

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

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

suggestionsViewMode

enum ( SuggestionsViewMode )

শুধুমাত্র আউটপুট। নথিতে প্রযোজ্য সাজেশন ভিউ মোড।

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

body

object ( Body )

শুধুমাত্র আউটপুট। নথির মূল অংশ।

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

headers

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

শুধুমাত্র আউটপুট। নথির শিরোনাম, শিরোনাম ID দ্বারা কী করা হয়।

লিগ্যাসি ক্ষেত্র: পরিবর্তে, 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

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