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 ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

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

পরামিতি
course Id

string

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

item Id

string

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

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

পরামিতি
add On Token

string

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

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

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

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

string

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

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

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

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

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

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

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

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

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

,

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

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

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

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

HTTP অনুরোধ

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

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

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

পরামিতি
course Id

string

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

item Id

string

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

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

পরামিতি
add On Token

string

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

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

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

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

string

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

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

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

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

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

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

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

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

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