Membuat peristiwa. Coba sekarang atau lihat contohnya.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
calendarId |
string |
ID kalender. Untuk mengambil ID kalender, panggil metode calendarList.list. Jika Anda ingin mengakses kalender utama pengguna yang saat ini login, gunakan "primary " kata kunci.
|
Parameter kueri opsional | ||
conferenceDataVersion |
integer |
Nomor versi data konferensi yang didukung oleh klien API. Versi 0 mengasumsikan tidak ada dukungan data konferensi dan mengabaikan data konferensi dalam isi peristiwa. Versi 1 memungkinkan dukungan untuk penyalinan ConferenceData serta untuk membuat konferensi baru menggunakan kolom createRequest dari konferensiData. Defaultnya adalah 0.
Nilai yang dapat diterima adalah 0 hingga 1 , inklusif.
|
maxAttendees |
integer |
Jumlah maksimum peserta yang akan disertakan dalam respons. Jika ada lebih dari jumlah tamu yang ditentukan, hanya peserta yang akan ditampilkan. Opsional. |
sendNotifications |
boolean |
Tidak digunakan lagi. Sebagai gantinya, gunakan sendUpdates. Apakah akan mengirim notifikasi tentang pembuatan peristiwa baru. Perlu diperhatikan bahwa beberapa email mungkin tetap dikirim meskipun Anda menetapkan nilainya ke false . Defaultnya adalah false .
|
sendUpdates |
string |
Apakah akan mengirim notifikasi tentang pembuatan peristiwa baru. Perlu diperhatikan bahwa beberapa email mungkin masih dikirim. Defaultnya adalah false .
Nilai yang dapat diterima:
|
supportsAttachments |
boolean |
Apakah operasi yang menjalankan klien API mendukung lampiran peristiwa. Opsional. Defaultnya adalah Salah. |
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:
Cakupan |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, berikan Resource peristiwa dengan properti berikut:
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
Properti yang Diperlukan | |||
end |
nested object |
Waktu berakhir (eksklusif) acara. Untuk acara berulang, ini adalah waktu berakhirnya acara yang pertama. | |
start |
nested object |
Waktu mulai (inklusif) acara. Untuk acara rutin, ini adalah waktu mulai dari kejadian pertama. | |
Properti Opsional | |||
anyoneCanAddSelf |
boolean |
Apakah siapa saja dapat mengundang diri mereka ke acara (tidak digunakan lagi). Opsional. Defaultnya adalah Salah. | dapat ditulis |
attachments[].fileUrl |
string |
Link URL ke lampiran. Untuk menambahkan lampiran file Google Drive, gunakan format yang sama seperti di properti Wajib diisi saat menambahkan lampiran. |
dapat ditulis |
attendees[] |
list |
Para peserta acara. Lihat panduan Acara dengan tamu untuk informasi selengkapnya tentang cara menjadwalkan acara dengan pengguna kalender lainnya. Akun layanan harus menggunakan delegasi tingkat domain untuk mengisi daftar tamu. | dapat ditulis |
attendees[].additionalGuests |
integer |
Jumlah tamu tambahan. Opsional. Defaultnya adalah 0. | dapat ditulis |
attendees[].comment |
string |
Komentar respons peserta. Opsional. | dapat ditulis |
attendees[].displayName |
string |
Nama peserta, jika ada. Opsional. | dapat ditulis |
attendees[].email |
string |
Alamat email peserta, jika tersedia. Kolom ini harus ada saat menambahkan tamu. Alamat email tersebut harus valid sesuai dengan RFC5322. Wajib diisi saat menambahkan tamu. |
dapat ditulis |
attendees[].optional |
boolean |
Apakah ini tamu opsional. Opsional. Defaultnya adalah Salah. | dapat ditulis |
attendees[].resource |
boolean |
Apakah peserta adalah sumber daya. Hanya dapat ditetapkan saat tamu ditambahkan ke acara untuk pertama kalinya. Perubahan berikutnya akan diabaikan. Opsional. Defaultnya adalah Salah. | dapat ditulis |
attendees[].responseStatus |
string |
Status respons tamu. Kemungkinan nilainya adalah:
|
dapat ditulis |
colorId |
string |
Warna peristiwa. Ini adalah ID yang merujuk ke entri di bagian event dari definisi warna (lihat endpoint warna). Opsional. |
dapat ditulis |
conferenceData |
nested object |
Informasi terkait konferensi, seperti detail konferensi Google Meet. Untuk membuat detail konferensi baru, gunakan kolom createRequest . Untuk mempertahankan perubahan Anda, jangan lupa menetapkan parameter permintaan conferenceDataVersion ke 1 untuk semua permintaan perubahan peristiwa. |
dapat ditulis |
description |
string |
Deskripsi acara. Dapat berisi HTML. Opsional. | dapat ditulis |
end.date |
date |
Tanggal, dalam format "yyyy-mm-dd", jika ini adalah peristiwa sepanjang hari. | dapat ditulis |
end.dateTime |
datetime |
Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone . |
dapat ditulis |
end.timeZone |
string |
Zona waktu yang digunakan untuk menentukan waktu. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Eropa/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu acara, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara. | dapat ditulis |
eventType |
string |
Jenis peristiwa tertentu. Setelan ini tidak dapat diubah setelah acara dibuat. Kemungkinan nilainya adalah:
|
dapat ditulis |
extendedProperties.private |
object |
Properti yang bersifat pribadi untuk salinan acara yang muncul di kalender ini. | dapat ditulis |
extendedProperties.shared |
object |
Properti yang digunakan bersama di antara salinan acara di tamu lain kalender. | dapat ditulis |
focusTimeProperties |
nested object |
Data peristiwa Waktu Fokus. Digunakan jika eventType adalah focusTime . |
dapat ditulis |
gadget.display |
string |
Mode tampilan gadget. Tidak digunakan lagi. Kemungkinan nilainya adalah:
|
dapat ditulis |
gadget.height |
integer |
Tinggi gadget dalam piksel. Tinggi harus berupa bilangan bulat yang lebih besar dari 0. Opsional. Tidak digunakan lagi. | dapat ditulis |
gadget.iconLink |
string |
URL ikon gadget. Skema URL harus berupa HTTPS. Tidak digunakan lagi. | dapat ditulis |
gadget.link |
string |
URL gadget. Skema URL harus berupa HTTPS. Tidak digunakan lagi. | dapat ditulis |
gadget.preferences |
object |
Preferensi. | dapat ditulis |
gadget.title |
string |
Judul gadget. Tidak digunakan lagi. | dapat ditulis |
gadget.type |
string |
Jenis gadget. Tidak digunakan lagi. | dapat ditulis |
gadget.width |
integer |
Lebar gadget dalam piksel. Lebar harus berupa bilangan bulat yang lebih besar dari 0. Opsional. Tidak digunakan lagi. | dapat ditulis |
guestsCanInviteOthers |
boolean |
Apakah tamu selain penyelenggara dapat mengundang orang lain ke acara. Opsional. Nilai defaultnya adalah True. | dapat ditulis |
guestsCanModify |
boolean |
Apakah tamu selain penyelenggara dapat mengubah acara. Opsional. Defaultnya adalah Salah. | dapat ditulis |
guestsCanSeeOtherGuests |
boolean |
Apakah tamu selain penyelenggara dapat melihat siapa peserta acara. Opsional. Nilai defaultnya adalah True. | dapat ditulis |
id |
string |
ID peristiwa yang tidak transparan. Saat membuat acara tunggal atau berulang baru, Anda dapat menentukan ID acara tersebut. ID yang diberikan harus mematuhi aturan berikut:
Jika Anda tidak menentukan ID, ID tersebut akan dibuat oleh server secara otomatis. Perlu diketahui bahwa |
dapat ditulis |
location |
string |
Lokasi geografis acara dalam format teks bebas. Opsional. | dapat ditulis |
originalStartTime.date |
date |
Tanggal, dalam format "yyyy-mm-dd", jika ini adalah peristiwa sepanjang hari. | dapat ditulis |
originalStartTime.dateTime |
datetime |
Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone . |
dapat ditulis |
originalStartTime.timeZone |
string |
Zona waktu yang digunakan untuk menentukan waktu. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Eropa/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu acara, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara. | dapat ditulis |
outOfOfficeProperties |
nested object |
Data acara tidak di kantor. Digunakan jika eventType adalah outOfOffice . |
dapat ditulis |
recurrence[] |
list |
Daftar baris RRules, EXRules, RDATE, dan EXDATE untuk acara berulang, seperti yang ditentukan dalam RFC5545. Perhatikan bahwa baris DTSTART dan DTEND tidak diizinkan dalam kolom ini; waktu mulai dan waktu berakhir peristiwa ditentukan di kolom start dan end . Kolom ini dihilangkan untuk satu acara atau beberapa kejadian berulang. |
dapat ditulis |
reminders.overrides[] |
list |
Jika acara tidak menggunakan pengingat default, pengingat ini akan mencantumkan pengingat khusus untuk acara tersebut, atau, jika tidak disetel, menunjukkan bahwa tidak ada pengingat yang ditetapkan untuk acara ini. Jumlah maksimum pengingat penggantian adalah 5. | dapat ditulis |
reminders.overrides[].method |
string |
Metode yang digunakan oleh pengingat ini. Kemungkinan nilainya adalah:
Wajib diisi saat menambahkan pengingat. |
dapat ditulis |
reminders.overrides[].minutes |
integer |
Jumlah menit sebelum acara dimulai saat pengingat akan dipicu. Nilai yang valid adalah antara 0 dan 40320 (4 minggu dalam menit). Wajib diisi saat menambahkan pengingat. |
dapat ditulis |
reminders.useDefault |
boolean |
Apakah pengingat default kalender berlaku untuk acara. | dapat ditulis |
sequence |
integer |
Nomor urut sesuai dengan iKalender. | dapat ditulis |
source.title |
string |
Judul sumber; misalnya judul laman web atau subjek email. | dapat ditulis |
source.url |
string |
URL sumber yang mengarah ke resource. Skema URL harus HTTP atau HTTPS. | dapat ditulis |
start.date |
date |
Tanggal, dalam format "yyyy-mm-dd", jika ini adalah peristiwa sepanjang hari. | dapat ditulis |
start.dateTime |
datetime |
Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone . |
dapat ditulis |
start.timeZone |
string |
Zona waktu yang digunakan untuk menentukan waktu. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Eropa/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu acara, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara. | dapat ditulis |
status |
string |
Status acara. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
summary |
string |
Judul acara. | dapat ditulis |
transparency |
string |
Apakah acara memblokir waktu di kalender. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
visibility |
string |
Visibilitas acara. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
workingLocationProperties |
nested object |
Data peristiwa lokasi kerja. | dapat ditulis |
workingLocationProperties.customLocation |
object |
Jika ada, tentukan bahwa pengguna bekerja dari lokasi kustom. | dapat ditulis |
workingLocationProperties.customLocation.label |
string |
Label tambahan opsional untuk informasi tambahan. | dapat ditulis |
workingLocationProperties.homeOffice |
any value |
Jika ada, tentukan bahwa pengguna bekerja di rumah. | dapat ditulis |
workingLocationProperties.officeLocation |
object |
Jika ada, menyebutkan bahwa pengguna bekerja dari kantor. | dapat ditulis |
workingLocationProperties.officeLocation.buildingId |
string |
ID gedung opsional. Alamat ini harus merujuk ke ID gedung di database Resource organisasi. | dapat ditulis |
workingLocationProperties.officeLocation.deskId |
string |
ID desktop opsional. | dapat ditulis |
workingLocationProperties.officeLocation.floorId |
string |
ID lantai opsional. | dapat ditulis |
workingLocationProperties.officeLocation.floorSectionId |
string |
ID bagian lantai opsional. | dapat ditulis |
workingLocationProperties.officeLocation.label |
string |
Nama kantor yang ditampilkan di klien Kalender Web dan Seluler. Sebaiknya Anda merujuk nama gedung di database Fasilitas organisasi. | dapat ditulis |
workingLocationProperties.type |
string |
Jenis lokasi kerja. Kemungkinan nilainya adalah:
Wajib saat menambahkan properti lokasi kerja. |
dapat ditulis |
Respons
Jika berhasil, metode ini akan menampilkan Resource peristiwa dalam isi respons.
Contoh
Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).
Java
Menggunakan library klien Java.
// Refer to the Java quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/java // Change the scope to CalendarScopes.CALENDAR and delete any stored // credentials. Event event = new Event() .setSummary("Google I/O 2015") .setLocation("800 Howard St., San Francisco, CA 94103") .setDescription("A chance to hear more about Google's developer products."); DateTime startDateTime = new DateTime("2015-05-28T09:00:00-07:00"); EventDateTime start = new EventDateTime() .setDateTime(startDateTime) .setTimeZone("America/Los_Angeles"); event.setStart(start); DateTime endDateTime = new DateTime("2015-05-28T17:00:00-07:00"); EventDateTime end = new EventDateTime() .setDateTime(endDateTime) .setTimeZone("America/Los_Angeles"); event.setEnd(end); String[] recurrence = new String[] {"RRULE:FREQ=DAILY;COUNT=2"}; event.setRecurrence(Arrays.asList(recurrence)); EventAttendee[] attendees = new EventAttendee[] { new EventAttendee().setEmail("lpage@example.com"), new EventAttendee().setEmail("sbrin@example.com"), }; event.setAttendees(Arrays.asList(attendees)); EventReminder[] reminderOverrides = new EventReminder[] { new EventReminder().setMethod("email").setMinutes(24 * 60), new EventReminder().setMethod("popup").setMinutes(10), }; Event.Reminders reminders = new Event.Reminders() .setUseDefault(false) .setOverrides(Arrays.asList(reminderOverrides)); event.setReminders(reminders); String calendarId = "primary"; event = service.events().insert(calendarId, event).execute(); System.out.printf("Event created: %s\n", event.getHtmlLink());
Python
Menggunakan library klien Python.
# Refer to the Python quickstart on how to setup the environment: # https://developers.google.com/calendar/quickstart/python # Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any # stored credentials. event = { 'summary': 'Google I/O 2015', 'location': '800 Howard St., San Francisco, CA 94103', 'description': 'A chance to hear more about Google\'s developer products.', 'start': { 'dateTime': '2015-05-28T09:00:00-07:00', 'timeZone': 'America/Los_Angeles', }, 'end': { 'dateTime': '2015-05-28T17:00:00-07:00', 'timeZone': 'America/Los_Angeles', }, 'recurrence': [ 'RRULE:FREQ=DAILY;COUNT=2' ], 'attendees': [ {'email': 'lpage@example.com'}, {'email': 'sbrin@example.com'}, ], 'reminders': { 'useDefault': False, 'overrides': [ {'method': 'email', 'minutes': 24 * 60}, {'method': 'popup', 'minutes': 10}, ], }, } event = service.events().insert(calendarId='primary', body=event).execute() print 'Event created: %s' % (event.get('htmlLink'))
PHP
Menggunakan library klien PHP.
// Refer to the PHP quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/php // Change the scope to Google_Service_Calendar::CALENDAR and delete any stored // credentials. $event = new Google_Service_Calendar_Event(array( 'summary' => 'Google I/O 2015', 'location' => '800 Howard St., San Francisco, CA 94103', 'description' => 'A chance to hear more about Google\'s developer products.', 'start' => array( 'dateTime' => '2015-05-28T09:00:00-07:00', 'timeZone' => 'America/Los_Angeles', ), 'end' => array( 'dateTime' => '2015-05-28T17:00:00-07:00', 'timeZone' => 'America/Los_Angeles', ), 'recurrence' => array( 'RRULE:FREQ=DAILY;COUNT=2' ), 'attendees' => array( array('email' => 'lpage@example.com'), array('email' => 'sbrin@example.com'), ), 'reminders' => array( 'useDefault' => FALSE, 'overrides' => array( array('method' => 'email', 'minutes' => 24 * 60), array('method' => 'popup', 'minutes' => 10), ), ), )); $calendarId = 'primary'; $event = $service->events->insert($calendarId, $event); printf('Event created: %s\n', $event->htmlLink);
Ruby
Menggunakan library klien Ruby.
event = Google::Apis::CalendarV3::Event.new( summary: 'Google I/O 2015', location: '800 Howard St., San Francisco, CA 94103', description: 'A chance to hear more about Google\'s developer products.', start: Google::Apis::CalendarV3::EventDateTime.new( date_time: '2015-05-28T09:00:00-07:00', time_zone: 'America/Los_Angeles' ), end: Google::Apis::CalendarV3::EventDateTime.new( date_time: '2015-05-28T17:00:00-07:00', time_zone: 'America/Los_Angeles' ), recurrence: [ 'RRULE:FREQ=DAILY;COUNT=2' ], attendees: [ Google::Apis::CalendarV3::EventAttendee.new( email: 'lpage@example.com' ), Google::Apis::CalendarV3::EventAttendee.new( email: 'sbrin@example.com' ) ], reminders: Google::Apis::CalendarV3::Event::Reminders.new( use_default: false, overrides: [ Google::Apis::CalendarV3::EventReminder.new( reminder_method: 'email', minutes: 24 * 60 ), Google::Apis::CalendarV3::EventReminder.new( reminder_method: 'popup', minutes: 10 ) ] ) ) result = client.insert_event('primary', event) puts "Event created: #{result.html_link}"
.NET
Menggunakan library klien.NET.
// Refer to the .NET quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/dotnet // Change the scope to CalendarService.Scope.Calendar and delete any stored // credentials. Event newEvent = new Event() { Summary = "Google I/O 2015", Location = "800 Howard St., San Francisco, CA 94103", Description = "A chance to hear more about Google's developer products.", Start = new EventDateTime() { DateTime = DateTime.Parse("2015-05-28T09:00:00-07:00"), TimeZone = "America/Los_Angeles", }, End = new EventDateTime() { DateTime = DateTime.Parse("2015-05-28T17:00:00-07:00"), TimeZone = "America/Los_Angeles", }, Recurrence = new String[] { "RRULE:FREQ=DAILY;COUNT=2" }, Attendees = new EventAttendee[] { new EventAttendee() { Email = "lpage@example.com" }, new EventAttendee() { Email = "sbrin@example.com" }, }, Reminders = new Event.RemindersData() { UseDefault = false, Overrides = new EventReminder[] { new EventReminder() { Method = "email", Minutes = 24 * 60 }, new EventReminder() { Method = "sms", Minutes = 10 }, } } }; String calendarId = "primary"; EventsResource.InsertRequest request = service.Events.Insert(newEvent, calendarId); Event createdEvent = request.Execute(); Console.WriteLine("Event created: {0}", createdEvent.HtmlLink);
Go
Menggunakan library klien Go.
// Refer to the Go quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/go // Change the scope to calendar.CalendarScope and delete any stored credentials. event := &calendar.Event{ Summary: "Google I/O 2015", Location: "800 Howard St., San Francisco, CA 94103", Description: "A chance to hear more about Google's developer products.", Start: &calendar.EventDateTime{ DateTime: "2015-05-28T09:00:00-07:00", TimeZone: "America/Los_Angeles", }, End: &calendar.EventDateTime{ DateTime: "2015-05-28T17:00:00-07:00", TimeZone: "America/Los_Angeles", }, Recurrence: []string{"RRULE:FREQ=DAILY;COUNT=2"}, Attendees: []*calendar.EventAttendee{ &calendar.EventAttendee{Email:"lpage@example.com"}, &calendar.EventAttendee{Email:"sbrin@example.com"}, }, } calendarId := "primary" event, err = srv.Events.Insert(calendarId, event).Do() if err != nil { log.Fatalf("Unable to create event. %v\n", err) } fmt.Printf("Event created: %s\n", event.HtmlLink)
JavaScript
Menggunakan library klien JavaScript.
// Refer to the JavaScript quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/js // Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any // stored credentials. var event = { 'summary': 'Google I/O 2015', 'location': '800 Howard St., San Francisco, CA 94103', 'description': 'A chance to hear more about Google\'s developer products.', 'start': { 'dateTime': '2015-05-28T09:00:00-07:00', 'timeZone': 'America/Los_Angeles' }, 'end': { 'dateTime': '2015-05-28T17:00:00-07:00', 'timeZone': 'America/Los_Angeles' }, 'recurrence': [ 'RRULE:FREQ=DAILY;COUNT=2' ], 'attendees': [ {'email': 'lpage@example.com'}, {'email': 'sbrin@example.com'} ], 'reminders': { 'useDefault': false, 'overrides': [ {'method': 'email', 'minutes': 24 * 60}, {'method': 'popup', 'minutes': 10} ] } }; var request = gapi.client.calendar.events.insert({ 'calendarId': 'primary', 'resource': event }); request.execute(function(event) { appendPre('Event created: ' + event.htmlLink); });
Node.js
Menggunakan library klien Node.js.
// Refer to the Node.js quickstart on how to setup the environment: // https://developers.google.com/calendar/quickstart/node // Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any // stored credentials. var event = { 'summary': 'Google I/O 2015', 'location': '800 Howard St., San Francisco, CA 94103', 'description': 'A chance to hear more about Google\'s developer products.', 'start': { 'dateTime': '2015-05-28T09:00:00-07:00', 'timeZone': 'America/Los_Angeles', }, 'end': { 'dateTime': '2015-05-28T17:00:00-07:00', 'timeZone': 'America/Los_Angeles', }, 'recurrence': [ 'RRULE:FREQ=DAILY;COUNT=2' ], 'attendees': [ {'email': 'lpage@example.com'}, {'email': 'sbrin@example.com'}, ], 'reminders': { 'useDefault': false, 'overrides': [ {'method': 'email', 'minutes': 24 * 60}, {'method': 'popup', 'minutes': 10}, ], }, }; calendar.events.insert({ auth: auth, calendarId: 'primary', resource: event, }, function(err, event) { if (err) { console.log('There was an error contacting the Calendar service: ' + err); return; } console.log('Event created: %s', event.htmlLink); });
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.