どのリソースにもバージョン フィールドがあり、このフィールドは
変更 - etag フィールド。ETag は HTTP の標準部分であり、
Calendar API は、次の 2 つのケースでサポートされます。
- その間、このリソースへの他の書き込みがないことを確認するためのリソース変更（条件付き変更）
- リソースの取得時に、リソースが変更された場合にのみリソースデータを取得する（条件付き取得）
条件付き変更
変更が行われていないリソースを更新または削除したい
その文字列を含む If-Match ヘッダーを指定できます。
以前の取得された ETag の値。これは kubectl の
失われる可能性があります。クライアントは、
変更を再適用できます。
エントリ（およびその ETag）が最後の取得以降に変更されていない場合、 変更が成功し、新しい ETag を持つ新しいバージョンのリソースが 返されます。それ以外の場合は、412（前提条件の失敗）レスポンス コードが返されます。
以下のサンプルコードのスニペットは、条件付きルールを適用する方法を示しています。 Pod の Java クライアント ライブラリ。
private static void run() throws IOException {
// Create a test event.
Event event = Utils.createTestEvent(client, "Test Event");
System.out.println(String.format("Event created: %s", event.getHtmlLink()));
// Pause while the user modifies the event in the Calendar UI.
System.out.println("Modify the event's description and hit enter to continue.");
System.in.read();
// Modify the local copy of the event.
event.setSummary("Updated Test Event");
// Update the event, making sure that we don't overwrite other changes.
int numAttempts = 0;
boolean isUpdated = false;
do {
Calendar.Events.Update request = client.events().update("primary", event.getId(), event);
request.setRequestHeaders(new HttpHeaders().setIfMatch(event.getEtag()));
try {
event = request.execute();
isUpdated = true;
} catch (GoogleJsonResponseException e) {
if (e.getStatusCode() == 412) {
// A 412 status code, "Precondition failed", indicates that the etag values didn't
// match, and the event was updated on the server since we last retrieved it. Use
// {@link Calendar.Events.Get} to retrieve the latest version.
Event latestEvent = client.events().get("primary", event.getId()).execute();
// You may want to have more complex logic here to resolve conflicts. In this sample we're
// simply overwriting the summary.
latestEvent.setSummary(event.getSummary());
event = latestEvent;
} else {
throw e;
}
}
numAttempts++;
} while (!isUpdated && numAttempts <= MAX_UPDATE_ATTEMPTS);
if (isUpdated) {
System.out.println("Event updated.");
} else {
System.out.println(String.format("Failed to update event after %d attempts.", numAttempts));
}
}
条件付き取得
最後に変更したリソースのみを取得する場合
取得した場合は、指定した内容を含む If-None-Match ヘッダーを
以前の取得された ETag の値。エントリ（つまりその ETag）が
変更されている場合、そのリソースの新しいバージョンは、
新しい ETag が返されます。そうしないと、304（Not Modified）が返されます。
レスポンス コード。
以下のサンプルコードのスニペットは、条件付きルールを適用する方法を示しています。 使用して取得します。 Java クライアント ライブラリ。
private static void run() throws IOException {
// Create a test event.
Event event = Utils.createTestEvent(client, "Test Event");
System.out.println(String.format("Event created: %s", event.getHtmlLink()));
// Pause while the user modifies the event in the Calendar UI.
System.out.println("Modify the event's description and hit enter to continue.");
System.in.read();
// Fetch the event again if it's been modified.
Calendar.Events.Get getRequest = client.events().get("primary", event.getId());
getRequest.setRequestHeaders(new HttpHeaders().setIfNoneMatch(event.getEtag()));
try {
event = getRequest.execute();
System.out.println("The event was modified, retrieved latest version.");
} catch (GoogleJsonResponseException e) {
if (e.getStatusCode() == 304) {
// A 304 status code, "Not modified", indicates that the etags match, and the event has
// not been modified since we last retrieved it.
System.out.println("The event was not modified, using local version.");
} else {
throw e;
}
}
}