Method: courses.courseWork.getAddOnContext

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

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

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

  • অ্যাক্সেস ত্রুটির জন্য 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-এ পুনঃনির্দেশিত করা হয় তখন টোকেনটি একটি ক্যোয়ারী প্যারামিটার হিসাবে পাস করা হয়।

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

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

string

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

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

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

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

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

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

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

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

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