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