Dokumen ini memberikan informasi tentang memublikasikan pesan.
Aplikasi penayang membuat dan mengirim pesan ke topik. Pub/Sub menawarkan pengiriman pesan setidaknya sekali dan pengurutan upaya terbaik kepada pelanggan yang sudah ada.
Alur umum untuk aplikasi penayang adalah:
- Buat pesan yang berisi data Anda.
- Kirim permintaan ke server Pub/Sub untuk memublikasikan pesan ke topik yang ditentukan.
Sebelum memulai
Sebelum mengonfigurasi alur kerja publikasi, pastikan Anda telah menyelesaikan tugas berikut:
- Pelajari alur kerja publikasi.
- Buat topik.
- Pilih dan buat langganan.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna memublikasikan pesan ke topik, minta administrator untuk memberi Anda peran IAM Pub/Sub Publisher (roles/pubsub.publisher) pada topik.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Anda memerlukan izin tambahan untuk membuat atau memperbarui topik dan langganan.
Format pesan
Pesan terdiri dari kolom dengan data dan metadata pesan. Tentukan setidaknya salah satu dari berikut ini dalam pesan:
- Data pesan
- Kunci pengurutan
- Atribut dengan metadata tambahan
Layanan Pub/Sub menambahkan kolom berikut ke pesan:
- ID pesan yang unik untuk topik
- Stempel waktu saat layanan Pub/Sub menerima pesan
Untuk mempelajari pesan lebih lanjut, lihat Format pesan.
Memublikasikan pesan
Anda dapat memublikasikan pesan dengan Google Cloud konsol, Google Cloud CLI, Pub/Sub API, dan library klien. Library klien dapat memublikasikan pesan secara asinkron.
Contoh berikut menunjukkan cara memublikasikan pesan ke topik.
Konsol
Untuk memublikasikan pesan, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Pub/Sub topics.
Klik ID topik.
Di halaman Topic details di bagian Messages, klik Publish message.
Di kolom Isi pesan, masukkan data pesan.
Klik Publikasikan.
gcloud
Untuk memublikasikan pesan, gunakan perintah gcloud pubsub topics publish:
gcloud pubsub topics publish TOPIC_ID \ --message=MESSAGE_DATA \ [--attribute=KEY="VALUE",...]
Ganti kode berikut:
- TOPIC_ID: ID topik
- MESSAGE_DATA: string dengan data pesan
- KEY: kunci atribut pesan
- VALUE: nilai untuk kunci atribut pesan
REST
Untuk memublikasikan pesan, kirim permintaan POST seperti berikut:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID:publish Content-Type: application/json Authorization: Bearer $(gcloud auth application-default print-access-token)
Ganti kode berikut:
- PROJECT_ID: project ID project dengan topik
- TOPIC_ID: ID topik
Tentukan kolom berikut dalam isi permintaan:
{
"messages": [
{
"attributes": {
"KEY": "VALUE",
...
},
"data": "MESSAGE_DATA",
}
]
}Ganti kode berikut:
- KEY: kunci atribut pesan
- VALUE: nilai untuk kunci atribut pesan
- MESSAGE_DATA: string berenkode base64 dengan data pesan
Pesan harus berisi kolom data yang tidak kosong atau minimal satu atribut.
Jika permintaan berhasil, responsnya adalah objek JSON dengan ID pesan. Contoh berikut adalah respons dengan ID pesan:
{
"messageIds": [
"19916711285",
]
}C++
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C++ di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C++ Pub/Sub.
C#
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Pub/Sub.