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 belirtilencloudPubsubTopic
geçerli değil ya dafeed
belirtilmemiş veya belirtilenfeed
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ş.
- belirtilen
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.