Add-on Google Classroom kini tersedia secara umum untuk developer. Lihat
dokumentasi add-on untuk informasi selengkapnya.
Method: courses.checkGradingPeriodsSetupEligibility
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menampilkan apakah pengguna memenuhi syarat untuk memperbarui GradingPeriodSettings di kursus tertentu.Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan UserProfiles.checkUserCapability
Metode ini menampilkan kode error berikut:
PERMISSION_DENIED untuk error akses.INVALID_ARGUMENT jika permintaan memiliki format yang salah.NOT_FOUND jika kursus yang diminta tidak ada.
Permintaan HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
courseId |
string
Wajib. ID kursus.
|
Parameter kueri
| Parameter |
previewVersion |
enum (PreviewVersion)
Opsional. Versi pratinjau API. Ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer di Program Pratinjau.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Apakah pengguna diizinkan untuk memperbarui GradingPeriodSettings di kursus ini.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"courseId": string,
"isGradingPeriodsSetupEligible": boolean,
"previewVersion": enum (PreviewVersion)
} |
| Kolom |
courseId |
string
Tidak dapat diubah. ID kursus.
|
isGradingPeriodsSetupEligible |
boolean
Apakah pengguna diizinkan untuk memperbarui GradingPeriodSettings di kursus ini.
|
previewVersion |
enum (PreviewVersion)
Hanya output. Versi pratinjau API. Ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer di Program Pratinjau.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
Untuk informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],[],null,["# Method: courses.checkGradingPeriodsSetupEligibility\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.CheckGradingPeriodsSetupEligibilityResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\n| This item is deprecated!\n\u003cbr /\u003e\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. This feature is available in [V1_20240401_PREVIEW](https://developers.google.com/workspace/classroom/reference/rest/v1/PreviewVersion) and later. See [Access Preview APIs](https://developers.google.com/workspace/classroom/reference/preview) to learn more.\nReturns whether a user is eligible to update GradingPeriodSettings in a given course.\n\n\u003cbr /\u003e\n\nThis method is deprecated. Use [`UserProfiles.checkUserCapability`](/workspace/classroom/reference/rest/v1/userProfiles/checkUserCapability#body.PATH_PARAMETERS.user_id) instead.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------------------------|\n| `courseId` | `string` Required. The identifier of the course. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nWhether the user is allowed to update GradingPeriodSettings in this course.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"isGradingPeriodsSetupEligible\": boolean, \"previewVersion\": enum (/workspace/classroom/reference/rest/v1/PreviewVersion) } ``` |\n\n| Fields ||\n|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Immutable. The identifier of the course. |\n| `isGradingPeriodsSetupEligible` | `boolean` Whether the user is allowed to update the GradingPeriodSettings in this course. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Output only. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n- `\n https://www.googleapis.com/auth/classroom.courses.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
