Dokumen ini menunjukkan cara memublikasikan pesan ke topik dengan skema.
Sebelum memulai
Sebelum mengonfigurasi alur kerja publikasi, pastikan Anda telah menyelesaikan tugas berikut:
- Pahami cara kerja skema Pub/Sub.
- Mengaitkan skema dengan topik.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna memublikasikan pesan ke topik, minta administrator Anda untuk memberi Anda peran IAM Pub/Sub Publisher (roles/pubsub.publisher
) di 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.Memublikasikan pesan dengan skema
Anda dapat memublikasikan pesan ke topik yang terkait dengan skema. Anda harus mengenkode pesan dalam skema dan format yang Anda tentukan saat Anda membuat topik. Pesan cocok dengan skema yang terkait dengan topik jika cocok dengan revisi skema apa pun dalam rentang revisi yang diizinkan. Pesan dievaluasi terhadap revisi dalam urutan dari revisi yang diizinkan terbaru hingga kecocokan ditemukan atau revisi yang diizinkan terlama tercapai. Pub/Sub menambahkan atribut berikut ke pesan yang berhasil dipublikasikan ke topik yang terkait dengan skema:
googclient_schemaname
: Nama skema yang digunakan untuk validasi.googclient_schemaencoding
: Encoding pesan, baik JSON maupun BINARY.googclient_schemarevisionid
: ID revisi skema yang digunakan untuk mengurai dan memvalidasi pesan. Setiap revisi memiliki ID revisi unik yang terkait dengannya. ID revisi adalah UUID delapan karakter yang dibuat secara otomatis.
Jika pesan tidak cocok dengan revisi skema yang diizinkan oleh topik, Pub/Sub akan menampilkan error INVALID_ARGUMENT
ke permintaan publikasi.
Pub/Sub hanya mengevaluasi pesan terhadap revisi skema pada waktu publikasi. Melakukan revisi skema baru atau mengubah skema yang terkait dengan topik setelah memublikasikan pesan tidak akan mengevaluasi ulang pesan tersebut atau mengubah atribut pesan skema terlampir.
Anda dapat memublikasikan pesan ke topik dengan skema terkait dalam project Google Cloud menggunakan konsol Google Cloud, gcloud CLI, Pub/Sub API, atau Cloud Client Libraries.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Publikasikan pesan contoh menggunakan perintah gcloud pubsub topics publish.
gcloud pubsub topics publish TOPIC_ID \ --message=MESSAGE
Ganti kode berikut:
TOPIC_ID: Nama topik yang sudah Anda buat.
MESSAGE: Pesan yang dipublikasikan ke topik. Contoh pesan dapat berupa
{"name": "Alaska", "post_abbr": "AK"}
.
C++
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C++ di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Pub/Sub C++ API.
Avro ProtoC#
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.
Avro ProtoGo
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Pub/Sub Go API.
Avro ProtoJava
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Pub/Sub Java API.
Avro ProtoNode.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Pub/Sub.
Avro Buffering ProtokolNode.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Pub/Sub.
Avro Buffering ProtokolPHP
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Pub/Sub.
Avro Buffering ProtokolPython
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Pub/Sub Python API.
Avro Buffering ProtokolRuby
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Pub/Sub.
Avro Buffering ProtokolLangkah berikutnya
Untuk membatasi lokasi tempat Pub/Sub menyimpan data pesan, lihat Membatasi lokasi resource Pub/Sub.
Untuk mempelajari lebih lanjut cara menerima pesan, lihat Memilih jenis langganan.