Method: users.watch

Menyiapkan atau memperbarui smartwatch notifikasi push di kotak surat pengguna tertentu.

Permintaan HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/watch

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
userId

string

Alamat email pengguna. Nilai khusus me dapat digunakan untuk menunjukkan pengguna yang diautentikasi.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "labelIds": [
    string
  ],
  "labelFilterAction": enum (LabelFilterAction),
  "labelFilterBehavior": enum (LabelFilterAction),
  "topicName": string
}
Kolom
labelIds[]

string

Daftar labelId yang notifikasinya akan dibatasi. Secara default, jika tidak ditentukan, semua perubahan akan didorong. Jika ditentukan, label akan menentukan label mana yang diperlukan agar notifikasi push dibuat.

labelFilterAction
(deprecated)

enum (LabelFilterAction)

Perilaku pemfilteran labelIds list ditentukan. Kolom ini tidak digunakan lagi karena menyebabkan perilaku yang salah dalam beberapa kasus; sebagai gantinya, gunakan labelFilterBehavior.

labelFilterBehavior

enum (LabelFilterAction)

Perilaku pemfilteran labelIds list ditentukan. Kolom ini menggantikan labelFilterAction; jika ditetapkan, labelFilterAction akan diabaikan.

topicName

string

Nama topik Google Cloud Pub/Sub API yang sepenuhnya memenuhi syarat untuk memublikasikan peristiwa. Nama topik ini harus sudah ada di Cloud Pub/Sub dan Anda harus sudah memberikan izin "publish" pada Gmail untuk nama tersebut. Misalnya, "projects/my-project-identifier/topics/my-topic-name" (menggunakan format penamaan topik Cloud Pub/Sub "v1").

Perhatikan bahwa bagian "my-project-identifier" harus sama persis dengan ID project developer Google Anda (yang menjalankan permintaan smartwatch ini).

Isi respons

Respons jam notifikasi push.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "historyId": string,
  "expiration": string
}
Kolom
historyId

string

ID catatan histori kotak surat saat ini.

expiration

string (int64 format)

Kapan Gmail akan berhenti mengirim notifikasi pembaruan kotak surat (milis epoch). Panggil watch lagi sebelum waktu ini untuk memperpanjang smartwatch.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Untuk informasi selengkapnya, lihat Panduan otorisasi.

LabelFilterAction

Perilaku pemfilteran daftar labelIds yang ditentukan.

Enum
include Hanya mendapatkan notifikasi push untuk perubahan pesan yang terkait dengan labelIds yang ditentukan.
exclude Dapatkan notifikasi push untuk semua perubahan pesan kecuali yang terkait dengan labelIds yang ditentukan.