Method: documents.create

অনুরোধে দেওয়া শিরোনাম ব্যবহার করে একটি ফাঁকা নথি তৈরি করে। অনুরোধের অন্যান্য ক্ষেত্র, প্রদত্ত সামগ্রী সহ, উপেক্ষা করা হয়৷

তৈরি নথি ফেরত দেয়।

HTTP অনুরোধ

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

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

শরীরের অনুরোধ

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

JSON প্রতিনিধিত্ব
{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
ক্ষেত্র
documentId

string

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

title

string

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

body

object ( Body )

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

headers

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

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

footers

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

শুধুমাত্র আউটপুট। নথিতে ফুটার, ফুটার আইডি দ্বারা কী করা হয়েছে।

footnotes

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

শুধুমাত্র আউটপুট। নথিতে ফুটনোট, ফুটনোট আইডি দ্বারা কী করা হয়েছে৷

documentStyle

object ( DocumentStyle )

শুধুমাত্র আউটপুট। নথির শৈলী।

suggestedDocumentStyleChanges

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

শুধুমাত্র আউটপুট। নথির শৈলীতে প্রস্তাবিত পরিবর্তন, সাজেশন আইডি দ্বারা চাবিকাঠি।

namedStyles

object ( NamedStyles )

শুধুমাত্র আউটপুট। নথির নামকৃত শৈলী।

suggestedNamedStylesChanges

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

শুধুমাত্র আউটপুট। নথির নামযুক্ত শৈলীতে প্রস্তাবিত পরিবর্তনগুলি, সাজেশন আইডি দ্বারা কী করা হয়েছে৷

lists

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

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

namedRanges

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

শুধুমাত্র আউটপুট। নথিতে নামযুক্ত ব্যাপ্তিগুলি, নামের দ্বারা কী করা হয়েছে৷

revisionId

string

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

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

suggestionsViewMode

enum ( SuggestionsViewMode )

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

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

inlineObjects

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

শুধুমাত্র আউটপুট। নথিতে ইনলাইন অবজেক্ট, অবজেক্ট আইডি দ্বারা কীড।

positionedObjects

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

শুধুমাত্র আউটপুট। নথিতে অবস্থানকৃত অবজেক্ট, অবজেক্ট আইডি দ্বারা কীড।

প্রতিক্রিয়া শরীর

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

অনুমোদনের সুযোগ

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

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

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