Method: courses.announcements.modifyAssignees

Modifie le mode et les options d'attribution d'une annonce.

Seul un enseignant du cours contenant l'annonce peut appeler cette méthode.

Cette méthode renvoie les codes d'erreur suivants :

  • PERMISSION_DENIED si l'utilisateur qui envoie la demande n'est pas autorisé à accéder au cours ou au devoir demandé, ou en cas d'erreur d'accès.
  • INVALID_ARGUMENT si la requête est mal formulée.
  • NOT_FOUND si le cours ou le devoir demandé n'existe pas.
  • FAILED_PRECONDITION pour l'erreur de requête suivante :
    • EmptyAssignees

Requête HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Identifiant du cours. Cet identifiant peut être celui attribué par Classroom ou un alias.
id

string

Identifiant de l'annonce.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
Champs
assigneeMode

enum (AssigneeMode)

Mode de l'annonce indiquant si elle est accessible à tous les élèves ou à certains élèves.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Définissez les élèves qui peuvent ou ne peuvent pas voir l'annonce. Doit être spécifié uniquement lorsque assigneeMode est défini sur INDIVIDUAL_STUDENTS.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Announcement.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.announcements

Pour en savoir plus, consultez le guide d'autorisation.