Method: courses.courseWork.getAddOnContext

একটি নির্দিষ্ট পোস্টের প্রসঙ্গে ক্লাসরুম অ্যাড-অনগুলির জন্য মেটাডেটা পায়।

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

এই পদ্ধতি নিম্নলিখিত ত্রুটি কোড প্রদান করে:

  • অ্যাক্সেস ত্রুটির জন্য PERMISSION_DENIED ।
  • অনুরোধটি ত্রুটিপূর্ণ হলে INVALID_ARGUMENT ৷
  • NOT_FOUND যদি চিহ্নিত সম্পদগুলির মধ্যে একটি বিদ্যমান না থাকে।

HTTP অনুরোধ

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnContext

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

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

পরামিতি
courseId

string

প্রয়োজন। কোর্সের শনাক্তকারী।

itemId

string

ঘোষণার শনাক্তকারী, কোর্সওয়ার্ক বা কোর্সওয়ার্কমেটেরিয়াল যার অধীনে সংযুক্তি সংযুক্ত করা হয়েছে৷ এই ক্ষেত্রটি প্রয়োজনীয়, কিন্তু আমরা পোস্টআইডি থেকে স্থানান্তরিত করার সময় এটিকে চিহ্নিত করা হয় না।

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

পরামিতি
addOnToken

string

ঐচ্ছিক। টোকেন যা অনুরোধ অনুমোদন করে।

যখন ব্যবহারকারীকে ক্লাসরুম থেকে অ্যাড-অনের URL-এ পুনঃনির্দেশিত করা হয় তখন টোকেনটি একটি ক্যোয়ারী প্যারামিটার হিসাবে পাস করা হয়।

অনুমোদন টোকেন প্রয়োজন যখন নিচের কোনটিই সত্য নয়:

  • অ্যাড-অন পোস্টে সংযুক্তি আছে.
  • বিকাশকারী প্রকল্পটি অনুরোধ জারি করে সেই একই প্রকল্প যা পোস্ট তৈরি করেছে।

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

অনুরোধের বডি খালি হতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডিতে AddOnContext এর একটি উদাহরণ থাকে।

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

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

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

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