Method: registrations.create

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.