Google Classroom eklentileri artık geliştiricilerin genel kullanımına sunuldu! Daha fazla bilgi edinmek için lütfen
eklenti belgelerini inceleyin.
Method: courses.checkGradingPeriodsSetupEligibility
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kullanıcının belirli bir kurstaki GradingPeriodSettings ayarlarını güncellemeye uygun olup olmadığını döndürür.Bu yöntemin desteği sonlandırılmıştır. Bunun yerine UserProfiles.checkUserCapability
Bu yöntem aşağıdaki hata kodlarını döndürür:
PERMISSION_DENIED için erişim hataları.INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.NOT_FOUND ise istenen kurs mevcut değildir.
HTTP isteği
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
courseId |
string
Zorunlu. Dersin tanımlayıcısıdır.
|
Sorgu parametreleri
| Parametreler |
previewVersion |
enum (PreviewVersion)
İsteğe bağlı. API'nin önizleme sürümü. Önizleme programında geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Kullanıcının bu kurstaki NotlandırmaDönemiAyarlarını güncellemesine izin verilip verilmediği.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"courseId": string,
"isGradingPeriodsSetupEligible": boolean,
"previewVersion": enum (PreviewVersion)
} |
| Alanlar |
courseId |
string
Değişmez. Dersin tanımlayıcısıdır.
|
isGradingPeriodsSetupEligible |
boolean
Kullanıcının bu kurstaki NotlandırmaDönemiAyarlarını güncellemesine izin verilip verilmeyeceği.
|
previewVersion |
enum (PreviewVersion)
Yalnızca çıkış. API'nin önizleme sürümü. Önizleme programında geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
