গুগল ক্লাসরুম অ্যাড-অনগুলি এখন সাধারণত বিকাশকারীদের জন্য উপলব্ধ! আরও তথ্যের জন্য
অ্যাড-অন ডকুমেন্টেশন দেখুন.
Method: userProfiles.guardianInvitations.list
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
প্রদত্ত পরামিতি দ্বারা ফিল্টার করা অভিভাবক আমন্ত্রণগুলির একটি তালিকা প্রদান করে যা অনুরোধকারী ব্যবহারকারীকে দেখার অনুমতি দেওয়া হয়েছে৷
এই পদ্ধতি নিম্নলিখিত ত্রুটি কোড প্রদান করে:
-
PERMISSION_DENIED যদি একটি studentId নির্দিষ্ট করা থাকে, এবং অনুরোধকারী ব্যবহারকারীকে সেই ছাত্রের অভিভাবক আমন্ত্রণগুলি দেখার অনুমতি দেওয়া হয় না, যদি "-" studentId হিসাবে নির্দিষ্ট করা হয় এবং ব্যবহারকারী ডোমেন প্রশাসক না হয়, যদি অভিভাবকরা প্রশ্নে থাকা ডোমেনের জন্য সক্ষম না থাকে, বা অন্যান্য অ্যাক্সেস ত্রুটির জন্য। -
INVALID_ARGUMENT যদি একটি studentId নির্দিষ্ট করা থাকে, কিন্তু এর বিন্যাসটি স্বীকৃত হতে পারে না (এটি একটি ইমেল ঠিকানা নয়, না API থেকে একটি studentId , বা আক্ষরিক স্ট্রিং me )। একটি অবৈধ pageToken বা state প্রদান করা হলে ফেরত দেওয়া হতে পারে। -
NOT_FOUND যদি একটি studentId নির্দিষ্ট করা হয়, এবং এর বিন্যাস স্বীকৃত হতে পারে, কিন্তু Classroom সেই ছাত্রের কোনো রেকর্ড নেই।
HTTP অনুরোধ
GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
| পরামিতি |
|---|
studentId | string যে শিক্ষার্থীর অভিভাবকদের আমন্ত্রণপত্র ফেরত দিতে হবে তার আইডি। শনাক্তকারী নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: - ব্যবহারকারীর জন্য সংখ্যাসূচক শনাক্তকারী
- ব্যবহারকারীর ইমেল ঠিকানা
- স্ট্রিং আক্ষরিক
"me" , অনুরোধকারী ব্যবহারকারীকে নির্দেশ করে - স্ট্রিং আক্ষরিক
"-" , যা নির্দেশ করে যে ফলাফলগুলি সমস্ত ছাত্রদের জন্য ফেরত দেওয়া উচিত যে অনুরোধকারী ব্যবহারকারীকে অভিভাবক আমন্ত্রণগুলি দেখার অনুমতি দেওয়া হয়েছে৷
|
ক্যোয়ারী প্যারামিটার
| পরামিতি |
|---|
invitedEmailAddress | string যদি নির্দিষ্ট করা থাকে, শুধুমাত্র নির্দিষ্ট invitedEmailAddress সহ ফলাফল ফেরত দেওয়া হয়। |
states[] | enum ( GuardianInvitationState ) যদি নির্দিষ্ট করা হয়, শুধুমাত্র নির্দিষ্ট state মান সহ ফলাফলগুলি ফেরত দেওয়া হয়। অন্যথায়, PENDING state সহ ফলাফল ফেরত দেওয়া হবে। |
pageToken | string nextPageToken মান একটি পূর্ববর্তী list কল থেকে ফিরে এসেছে, এটি নির্দেশ করে যে ফলাফলের পরবর্তী পৃষ্ঠাটি ফেরত দেওয়া উচিত। list অনুরোধটি অন্যথায় এই টোকেনটির ফলে অনুরূপ হতে হবে। |
pageSize | integer ফেরত দিতে আইটেম সর্বোচ্চ সংখ্যা. শূন্য বা অনির্দিষ্ট নির্দেশ করে যে সার্ভার সর্বোচ্চ বরাদ্দ করতে পারে। সার্ভার নির্দিষ্ট সংখ্যক ফলাফলের চেয়ে কম ফেরত দিতে পারে। |
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
অভিভাবক আমন্ত্রণ তালিকাভুক্ত করার সময় প্রতিক্রিয়া.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
| JSON প্রতিনিধিত্ব |
|---|
{
"guardianInvitations": [
{
object (GuardianInvitation)
}
],
"nextPageToken": string
} |
| ক্ষেত্র |
|---|
guardianInvitations[] | object ( GuardianInvitation ) অভিভাবকদের আমন্ত্রণগুলি যা তালিকার অনুরোধের সাথে মিলেছে৷ |
nextPageToken | string টোকেন চিহ্নিত করে ফলাফলের পরবর্তী পৃষ্ঠায় ফিরতে হবে। খালি থাকলে, আর কোন ফলাফল পাওয়া যায় না। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly -
https://www.googleapis.com/auth/classroom.guardianlinks.students
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। Java হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-07-25 UTC-তে শেষবার আপডেট করা হয়েছে।
[null,null,["2025-07-25 UTC-তে শেষবার আপডেট করা হয়েছে।"],[],[],null,["# Method: userProfiles.guardianInvitations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListGuardianInvitationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns a list of guardian invitations that the requesting user is permitted to view, filtered by the parameters provided.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if a `studentId` is specified, and the requesting user is not permitted to view guardian invitations for that student, if `\"-\"` is specified as the `studentId` and the user is not a domain administrator, if guardians are not enabled for the domain in question, or for other [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if a `studentId` is specified, but its format cannot be recognized (it is not an email address, nor a `studentId` from the API, nor the literal string `me`). May also be returned if an invalid `pageToken` or `state` is provided.\n- `NOT_FOUND` if a `studentId` is specified, and its format can be recognized, but Classroom has no record of that student.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `studentId` | `string` The ID of the student whose guardian invitations are to be returned. The identifier can be one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user - the string literal `\"-\"`, indicating that results should be returned for all students that the requesting user is permitted to view guardian invitations. |\n\n### Query parameters\n\n| Parameters ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `invitedEmailAddress` | `string` If specified, only results with the specified `invitedEmailAddress` are returned. |\n| `states[]` | `enum (`[GuardianInvitationState](/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations#GuardianInvitationState)`)` If specified, only results with the specified `state` values are returned. Otherwise, results with a `state` of `PENDING` are returned. |\n| `pageToken` | `string` [nextPageToken](/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations/list#body.ListGuardianInvitationsResponse.FIELDS.next_page_token) value returned from a previous [list](/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations/list#google.classroom.v1.GuardianInvitations.ListGuardianInvitations) call, indicating that the subsequent page of results should be returned. The [list](/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations/list#google.classroom.v1.GuardianInvitations.ListGuardianInvitations) request must be otherwise identical to the one that resulted in this token. |\n| `pageSize` | `integer` Maximum number of items to return. Zero or unspecified indicates that the server may assign a maximum. The server may return fewer than the specified number of results. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse when listing guardian invitations.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"guardianInvitations\": [ { object (/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations#GuardianInvitation) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `guardianInvitations[]` | `object (`[GuardianInvitation](/workspace/classroom/reference/rest/v1/userProfiles.guardianInvitations#GuardianInvitation)`)` Guardian invitations that matched the list request. |\n| `nextPageToken` | `string` Token identifying the next page of results to return. If empty, no further results are available. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly`\n- `\n https://www.googleapis.com/auth/classroom.guardianlinks.students`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
