Google Classroom eklentileri artık geliştiricilerin genel kullanımına sunuldu! Daha fazla bilgi edinmek için lütfen
eklenti belgelerini inceleyin.
Method: registrations.create
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Classroom'un, sağlanan feed adresinden cloudPubSubTopic adresine bildirim göndermeye başlamasına neden olan bir Registration oluşturur.
Oluşturulan Registration öğesini döndürür. Şu anda bu, bağımsız değişkenle aynıdır ancak expiryTime ve id gibi sunucu tarafından atanan alanlar doldurulur.
expiryTime veya id alanları için belirtilen tüm değerlerin yoksayıldığını unutmayın.
Classroom, cloudPubSubTopic değerini doğrulayabilir ve mümkün olduğunca hataları döndürebilir ancak bu değerin var olduğundan ve Classroom'ın bu alanda yayınlama izni olduğundan emin olmak arayan kullanıcının sorumluluğundadır.
Bu yöntem aşağıdaki hata kodlarını döndürebilir:
PERMISSION_DENIED ise:
- Kimliği doğrulanmış kullanıcının, istenen alandan bildirim alma izni yok veya
- Mevcut kullanıcı, istenen feed için uygun kapsamda mevcut Cloud projesine erişim izni vermemişse. Alan genelinde yetki verme işleminin şu anda bu amaç için desteklenmediğini unutmayın. İstek uygun kapsama sahipse ancak izin yoksa [Request Errors][
@MissingGrant hatası] döndürülür.
- başka bir erişim hatasıyla karşılaşılır.
INVALID_ARGUMENT ise:
- Hiçbir
cloudPubsubTopic belirtilmemiş veya belirtilen cloudPubsubTopic geçerli değilse ya da
feed belirtilmemiş veya belirtilen feed geçerli değil.
NOT_FOUND ise:
- Belirtilen
feed bulunamıyor veya istek gönderen kullanıcının, öğenin mevcut olup olmadığını belirleme izni yok veya
- Belirtilen
cloudPubsubTopic bulunamıyor veya Classroom'a içerik yayınlama izni verilmemiş.
HTTP isteği
POST https://classroom.googleapis.com/v1/registrations
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek metni, Registration öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir Registration örneği içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/classroom.push-notifications
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: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
