Method: registrations.create

Bir Registration oluşturur. Böylece Classroom, sağlanan feed kaynağından cloudPubSubTopic içinde sağlanan hedefe bildirim göndermeye başlar.

Oluşturulan Registration değerini döndürür. Şu anda bu, bağımsız değişkenle aynı olacaktır ancak expiryTime ve id gibi sunucu tarafından atanmış alanlar doldurulacaktır.

expiryTime veya id alanları için belirtilen tüm değerlerin yok sayılacağını unutmayın.

Classroom, cloudPubSubTopic öğesini doğrulayıp hata verebilir ancak en iyi sonucu elde etmek için uygulamanın mevcut olduğundan ve Classroom'un bu dokümanı yayınlama iznine sahip olduğundan emin olmak, arayanın sorumluluğundadır.

Bu yöntem aşağıdaki hata kodlarını döndürebilir:

  • Şu durumda PERMISSION_DENIED:
    • kimliği doğrulanan kullanıcının istenen alandan bildirim alma izni yoksa veya
    • Geçerli kullanıcı, istenen feed için uygun kapsamla geçerli Cloud projesine erişim izni vermemiştir. Alan genelinde yetki vermenin şu anda bu amaçla 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ı ile karşılaşırsınız.
  • Şu durumda INVALID_ARGUMENT:
    • cloudPubsubTopic belirtilmemiş veya belirtilen cloudPubsubTopic geçerli değil ya da
    • feed belirtilmemiş veya belirtilen feed geçerli değil.
  • Şu durumda NOT_FOUND:
    • belirtilen feed bulunamıyor veya istekte bulunan kullanıcının var olup olmadığını belirleme izni yok veya
    • belirtilen cloudPubsubTopic bulunamıyor veya Classroom'a bu öğeyi 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 gövdesi, yeni oluşturulan Registration örneğini 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 göz atın.