ユーザーが Classroom と Google Meet を使用している場合は、Google Meet コースの生徒の出席状況を確認する Apps Script クイックスタートをご覧ください。

Method: courses.announcements.create

お知らせを作成します。

このメソッドは、次のエラーコードを返します。

  • PERMISSION_DENIEDリクエストしたユーザーがリクエストされたコースにアクセスできない場合、リクエストされたコースでお知らせを作成する、ドライブの添付ファイルを共有する、またはアクセスエラー
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • NOT_FOUND: リクエストされたコースが存在しない場合。
  • 次のリクエスト エラーの場合は FAILED_PRECONDITION:
    • AttachmentNotVisible(添付ファイルの表示不可)

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

コースの ID。この ID は、Classroom で割り当てられた ID または alias のいずれかです。

リクエスト本文

リクエストの本文には Announcement のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Announcement のインスタンスが含まれます。

認証スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。