Method: spreadsheets.values.append

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

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

HTTP অনুরোধ

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

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

পাথ প্যারামিটার

পরামিতি
spreadsheetId

string

আপডেট করার জন্য স্প্রেডশীটের আইডি।

range

string

ডেটার একটি যৌক্তিক সারণী অনুসন্ধান করার জন্য একটি ব্যাপ্তির A1 স্বরলিপি । সারণীর শেষ সারির পরে মান যুক্ত করা হয়।

ক্যোয়ারী প্যারামিটার

পরামিতি
valueInputOption

enum ( ValueInputOption )

ইনপুট ডেটা কীভাবে ব্যাখ্যা করা উচিত।

insertDataOption

enum ( InsertDataOption )

কিভাবে ইনপুট ডেটা সন্নিবেশ করা উচিত।

includeValuesInResponse

boolean

আপডেট প্রতিক্রিয়া যোগ করা ঘরের মান অন্তর্ভুক্ত করা উচিত কিনা তা নির্ধারণ করে। ডিফল্টরূপে, প্রতিক্রিয়া আপডেট করা মান অন্তর্ভুক্ত করে না।

responseValueRenderOption

enum ( ValueRenderOption )

প্রতিক্রিয়ার মানগুলি কীভাবে রেন্ডার করা উচিত তা নির্ধারণ করে। ডিফল্ট রেন্ডার বিকল্পটি হল FORMATTED_VALUE ।

responseDateTimeRenderOption

enum ( DateTimeRenderOption )

প্রতিক্রিয়ায় তারিখ, সময় এবং সময়কাল কীভাবে রেন্ডার করা উচিত তা নির্ধারণ করে। responseValueRenderOption FORMATTED_VALUE হলে এটি উপেক্ষা করা হয়। ডিফল্ট dateTime রেন্ডার বিকল্প হল SERIAL_NUMBER ।

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

অনুরোধের মূল অংশে ValueRange এর একটি উদাহরণ রয়েছে।

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

একটি স্প্রেডশীটে মানগুলির একটি পরিসর আপডেট করার সময় প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
ক্ষেত্র
spreadsheetId

string

যে স্প্রেডশীটে আপডেটগুলি প্রয়োগ করা হয়েছিল৷

tableRange

string

সারণীর পরিসর (A1 স্বরলিপিতে) যেটিতে মানগুলি যুক্ত করা হচ্ছে (মানগুলি যুক্ত করার আগে)। কোন টেবিল পাওয়া না গেলে খালি।

updates

object ( UpdateValuesResponse )

যে আপডেটগুলি প্রয়োগ করা হয়েছিল সেগুলি সম্পর্কে তথ্য৷

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

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

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

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

InsertDataOption

নতুন ডেটা ইনপুট করার সময় বিদ্যমান ডেটা কীভাবে পরিবর্তিত হয় তা নির্ধারণ করে।

Enums
OVERWRITE নতুন ডেটা যে এলাকায় লেখা হয়েছে সেখানে বিদ্যমান ডেটা ওভাররাইট করে। (দ্রষ্টব্য: শীটের শেষে ডেটা যোগ করলে এখনও নতুন সারি বা কলাম সন্নিবেশ করা হবে যাতে ডেটা লেখা যায়।)
INSERT_ROWS নতুন ডেটার জন্য সারি ঢোকানো হয়।