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.updateGradingPeriodSettings
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir dersin notlandırma dönemi ayarlarını günceller.
Bu yöntemle, notlandırma dönemleri tek tek eklenebilir, kaldırılabilir veya değiştirilebilir.
İstekte bulunan kullanıcı ve kurs sahibi, notlandırma dönemlerini değiştirmeye uygun olmalıdır. Ayrıntılar için lisanslama koşullarına göz atın.
Bu yöntem aşağıdaki hata kodlarını döndürür:
PERMISSION_DENIED istek gönderen kullanıcının bir kurstaki notlandırma dönemi ayarlarını değiştirmesine izin verilmiyorsa veya erişim hataları için:
- UserIneligibleToUpdateGradingPeriodSettings
INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.NOT_FOUND ise istenen kurs mevcut değildir.
HTTP isteği
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings
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 |
updateMask |
string (FieldMask format)
GradingPeriodSettings'te hangi alanların güncelleneceğini tanımlayan maske. GradingPeriodSettings gradingPeriods listesi, güncelleme isteğinde belirtilen notlandırma dönemleriyle tamamen değiştirilir. Örneğin:
- Kimlik olmadan listeye eklenen notlandırma dönemleri ek olarak kabul edilir ve istek gönderildiğinde yeni bir kimlik atanır.
- Şu anda mevcut olan ancak istekte bulunmayan notlandırma dönemleri silinmiş olarak kabul edilir.
- Mevcut kimliği ve değiştirilmiş verileri olan notlandırma dönemleri düzenleme olarak kabul edilir. Değiştirilmemiş veriler olduğu gibi bırakılır.
- Bilinmeyen bir kimlikle birlikte eklenen notlandırma dönemleri hataya neden olur.
Aşağıdaki alanlar belirtilebilir:
gradingPeriodsapplyToExistingCoursework Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
|
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, GradingPeriodSettings öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, GradingPeriodSettings öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/classroom.courses
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.updateGradingPeriodSettings\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates grading period settings of a course.\n\nIndividual grading periods can be added, removed, or modified using this method.\n\nThe requesting user and course owner must be eligible to modify Grading Periods. For details, see [licensing requirements](https://developers.google.com/workspace/classroom/grading-periods/manage-grading-periods#licensing_requirements).\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to modify the grading period settings in a course or for [access errors](/workspace/classroom/reference/Access.Errors):\n - UserIneligibleToUpdateGradingPeriodSettings\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`\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| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Mask that identifies which fields in the GradingPeriodSettings to update. The GradingPeriodSettings `gradingPeriods` list will be fully replaced by the grading periods specified in the update request. For example: - Grading periods included in the list without an ID are considered additions, and a new ID will be assigned when the request is made. - Grading periods that currently exist, but are missing from the request will be considered deletions. - Grading periods with an existing ID and modified data are considered edits. Unmodified data will be left as is. - Grading periods included with an unknown ID will result in an error. The following fields may be specified: - `gradingPeriods` - `applyToExistingCoursework` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\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 contains an instance of [GradingPeriodSettings](/workspace/classroom/reference/rest/v1/GradingPeriodSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [GradingPeriodSettings](/workspace/classroom/reference/rest/v1/GradingPeriodSettings).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
