একটি নির্দিষ্ট পোস্টের প্রসঙ্গে ক্লাসরুম অ্যাড-অনগুলির জন্য মেটাডেটা পায়।
নিজস্ব ডেটা এবং অনুমতি মডেলের অখণ্ডতা বজায় রাখার জন্য, একটি অ্যাড-অনকে ক্যোয়ারী প্যারামিটার এবং অনুরোধকারী ব্যবহারকারীর ভূমিকা যাচাই করতে কল করা উচিত যখনই একটি iframe এ অ্যাড-অন খোলা হয়৷
Announcement শনাক্তকারী, CourseWork , বা CourseWorkMaterial যার অধীনে সংযুক্তি সংযুক্ত করা হয়েছে৷ এই ক্ষেত্রটি প্রয়োজনীয়, কিন্তু আমরা পোস্টআইডি থেকে স্থানান্তরিত করার সময় এটিকে চিহ্নিত করা হয় না।
ক্যোয়ারী প্যারামিটার
পরামিতি
postId (deprecated)
string
ঐচ্ছিক। অপ্রচলিত, পরিবর্তে itemId ব্যবহার করুন।
addOnToken
string
ঐচ্ছিক। টোকেন যা অনুরোধ অনুমোদন করে।
যখন ব্যবহারকারীকে ক্লাসরুম থেকে অ্যাড-অনের URL-এ পুনঃনির্দেশিত করা হয় তখন টোকেনটি একটি ক্যোয়ারী প্যারামিটার হিসাবে পাস করা হয়।
অনুমোদন টোকেন প্রয়োজন যখন নিচের কোনটিই সত্য নয়:
অ্যাড-অন পোস্টে সংযুক্তি আছে.
বিকাশকারী প্রকল্পটি অনুরোধ জারি করে সেই একই প্রকল্প যা পোস্ট তৈরি করেছে।
attachmentId
string
ঐচ্ছিক। সংযুক্তির শনাক্তকারী। ব্যবহারকারী সংযুক্তি আবিষ্কার আইফ্রেমে থাকা ব্যতীত সমস্ত অনুরোধের জন্য এই ক্ষেত্রটি প্রয়োজনীয়৷
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে AddOnContext এর একটি উদাহরণ থাকে।
[[["সহজে বোঝা যায়","easyToUnderstand","thumb-up"],["আমার সমস্যার সমাধান হয়েছে","solvedMyProblem","thumb-up"],["অন্যান্য","otherUp","thumb-up"]],[["এতে আমার প্রয়োজনীয় তথ্য নেই","missingTheInformationINeed","thumb-down"],["খুব জটিল / অনেক ধাপ","tooComplicatedTooManySteps","thumb-down"],["পুরনো","outOfDate","thumb-down"],["অনুবাদ সংক্রান্ত সমস্যা","translationIssue","thumb-down"],["নমুনা / কোড সংক্রান্ত সমস্যা","samplesCodeIssue","thumb-down"],["অন্যান্য","otherDown","thumb-down"]],["2024-10-30 UTC-তে শেষবার আপডেট করা হয়েছে।"],[[["Retrieves metadata for Classroom add-ons within a specific post, validating user roles and query parameters."],["Requires `courseId`, `itemId` as path parameters, with optional `postId`, `addOnToken`, and `attachmentId` as query parameters."],["Returns an `AddOnContext` object upon successful execution, with potential errors including `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND`."],["Needs authorization with either `https://www.googleapis.com/auth/classroom.addons.student` or `https://www.googleapis.com/auth/classroom.addons.teacher` scope."],["Add-ons should utilize this method for validation when opened in an iframe to maintain data and permission integrity."]]],[]]