Events: delete

Xoá một sự kiện. Thử ngay hoặc xem ví dụ.

Yêu cầu

Yêu cầu HTTP

DELETE https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

Thông số

Tên thông số Giá trị Mô tả
Thông số đường dẫn
calendarId string Giá trị nhận dạng lịch. Để truy xuất mã lịch, hãy gọi phương thức calendarList.list. Nếu bạn muốn truy cập vào lịch chính của người dùng hiện đã đăng nhập, hãy sử dụng từ khoá "primary".
eventId string Giá trị nhận dạng sự kiện.
Thông số truy vấn không bắt buộc
sendNotifications boolean Không dùng nữa. Vui lòng sử dụng sendUpdates.

Có gửi thông báo về việc xoá sự kiện hay không. Xin lưu ý rằng một số email vẫn có thể được gửi ngay cả khi bạn đặt giá trị thành false. Giá trị mặc định là false.
sendUpdates string Những khách sẽ nhận được thông báo về việc xoá sự kiện.

Các giá trị được chấp nhận là:
  • "all": Thông báo được gửi đến tất cả khách.
  • "externalOnly": Chỉ gửi thông báo cho khách không sử dụng Lịch Google.
  • "none": Không gửi thông báo. Đối với các tác vụ di chuyển lịch, hãy cân nhắc sử dụng phương thức Events.import.

Ủy quyền

Yêu cầu này yêu cầu uỷ quyền với ít nhất một trong các phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một nội dung phản hồi trống.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Sử dụng thư viện ứng dụng Java.

import com.google.api.services.calendar.Calendar;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Delete an event
service.events().delete('primary', "eventId").execute();

Python

Sử dụng thư viện ứng dụng Python.

service.events().delete(calendarId='primary', eventId='eventId').execute()

PHP

Sử dụng thư viện ứng dụng PHP.

$service->events->delete('primary', 'eventId');

Ruby

Sử dụng thư viện ứng dụng Ruby.

client.delete_event('primary', 'eventId')

Hãy dùng thử!

Sử dụng Trình khám phá API bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.