Pesan batch membuat klien penayang dengan setelan pengelompokan kustom dan menggunakannya untuk memublikasikan beberapa pesan.
Dokumen ini memberikan informasi tentang penggunaan pesan batch dengan pesan yang dipublikasikan ke topik.
Sebelum memulai
Sebelum mengonfigurasi alur kerja publikasi, pastikan Anda telah menyelesaikan tugas-tugas berikut:
- Pelajari topik dan alur kerja publikasi.
- Membuat topik.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk 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.
Menggunakan pesan batch
Lihat contoh kode berikut untuk mempelajari cara mengonfigurasi setelan pesan batch untuk penayang Anda.
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.
Go
Contoh berikut menggunakan versi utama library klien Pub/Sub Go (v2). Jika Anda masih menggunakan library v1, lihat panduan migrasi ke v2. Untuk melihat daftar contoh kode v1, lihat contoh kode yang tidak digunakan lagi.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan Memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Pub/Sub.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan Memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Pub/Sub.
Node.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.
Node.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.
PHP
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.
Python
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.
Ruby
Contoh berikut menggunakan library klien Pub/Sub Ruby v3. Jika Anda masih menggunakan library v2, lihat panduan migrasi ke v3. Untuk melihat daftar contoh kode Ruby v2, lihat contoh kode yang tidak digunakan lagi.
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.
Rust
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Rust di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Rust Pub/Sub.
Menonaktifkan pesan batch
Untuk menonaktifkan pengelompokan di library klien, tetapkan nilai max_messages ke 1.
Pesan batch dan pengiriman yang diurutkan
Dengan pengiriman yang diurutkan, kegagalan mengonfirmasi pesan apa pun dalam batch berarti bahwa semua pesan dalam batch, termasuk pesan yang dikirim sebelum pesan yang tidak dikonfirmasi, akan dikirim ulang.
Kuota dan batas pada pesan batch
Sebelum mengonfigurasi pengiriman pesan batch, pertimbangkan efek faktor seperti kuota throughput publikasi dan ukuran maksimum batch. Library klien tingkat tinggi memastikan bahwa permintaan batch tetap berada dalam batas yang ditentukan.
- 1.000 byte adalah ukuran permintaan minimum yang dipertimbangkan untuk tujuan biaya, meskipun ukuran pesan sebenarnya mungkin lebih kecil dari 1.000 byte.
- Pub/Sub memiliki batas ukuran 10 MB atau 1.000 pesan untuk satu permintaan publikasi batch.
Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas Pub/Sub.
Langkah berikutnya
Untuk mempelajari cara mengonfigurasi opsi publikasi lanjutan, lihat referensi berikut: