ユーザーのカレンダー リストの既存のカレンダーを更新します。このメソッドは、パッチ セマンティクスをサポートしています。なお、パッチ リクエストごとに割り当てユニットが 3 つ消費されます。get
の後に update
を付ける方が良いでしょう。指定したフィールド値によって、既存の値が置き換えられます。リクエストで指定しないフィールドは変更されません。配列フィールドを指定すると、既存の配列が上書きされます。前の配列要素が破棄されます。
こちらから今すぐお試しください。
リクエスト
HTTP リクエスト
PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
calendarId |
string |
カレンダーの ID。カレンダー ID を取得するには、calendarList.list メソッドを呼び出します。現在ログインしているユーザーのメイン カレンダーにアクセスするには、「primary 」を使用します。できます。
|
省略可能なクエリ パラメータ | ||
colorRgbFormat |
boolean |
foregroundColor フィールドと backgroundColor フィールドを使用してカレンダーの色(RGB)を書き込むかどうか。この機能を使用する場合は、インデックス ベースの colorId フィールドが最適なオプションに自動的に設定されます。省略可。デフォルトは False です。
|
承認
このリクエストには、次のスコープによる認証が必要です。
スコープ |
---|
https://www.googleapis.com/auth/calendar |
詳細については、認証と認可のページをご覧ください。
リクエスト本文
リクエストの本文には、パッチのセマンティクスのルールに従って、CalendarList リソースの関連する部分を指定します。
レスポンス
成功すると、このメソッドはレスポンスの本文で CalendarList リソースを返します。
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。