שליחת הודעות באצווה יוצרת לקוח של בעל תוכן דיגיטלי עם הגדרות אצווה בהתאמה אישית, ומשתמשת בו כדי לפרסם כמה הודעות.
במסמך הזה מוסבר איך משתמשים בהודעות באצווה עם הודעות שפורסמו בנושא.
לפני שמתחילים
לפני שמגדירים את תהליך העבודה של הפרסום, צריך לבצע את המשימות הבאות:
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לפרסום הודעות בנושא, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד פרסום הודעות ב-Pub/Sub (roles/pubsub.publisher) בנושא.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
כדי ליצור או לעדכן נושאים ומינויים, צריך הרשאות נוספות.
שימוש בהודעות באצווה
דוגמאות הקוד הבאות מראות איך להגדיר את ההגדרות של העברת הודעות באצווה לבעל האפליקציה.
C++
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C++ במאמר התחלה מהירה: שימוש בספריות לקוח. מידע נוסף זמין במאמרי העזרה של Pub/Sub C++ API.
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במאמר התחלה מהירה: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub C# API.
המשך
בדוגמה הבאה נעשה שימוש בגרסה הראשית של ספריית הלקוח של Pub/Sub ב-Go (v2). אם אתם עדיין משתמשים בספרייה של גרסה 1, כדאי לעיין במדריך להעברת נתונים לגרסה 2. כאן תוכלו למצוא רשימה של דוגמאות קוד שהוצאו משימוש בגרסה 1.
לפני שתנסו את הדוגמה הזו, פעלו לפי הוראות ההגדרה של Go במאמר מדריך למתחילים: שימוש בספריות לקוח. מידע נוסף מופיע במסמכי העזר של ה-API של Pub/Sub Go.
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במאמר התחלה מהירה: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub Java API.
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במאמר מדריך למתחילים: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub Node.js API.
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במאמר מדריך למתחילים: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub Node.js API.
PHP
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של PHP במאמר מדריך למתחילים: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub PHP API.
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במאמר התחלה מהירה: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של ה-API בשפת Python של Pub/Sub.
Ruby
בדוגמה הבאה נעשה שימוש בגרסה 3 של ספריית הלקוח של Pub/Sub ב-Ruby. אם אתם עדיין משתמשים בספרייה v2, עיינו במדריך להעברת נתונים (מיגרציה) ל-v3. לרשימה של דוגמאות קוד ב-Ruby v2, עיינו ב דוגמאות הקוד שהוצאו משימוש.
לפני שתנסו את הדוגמה הזו, פעלו לפי הוראות ההגדרה של Ruby במאמר התחלה מהירה: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub Ruby API.
Rust
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Rust במדריך למתחילים: שימוש בספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Pub/Sub Rust API.
השבתת שליחת הודעות באצווה
כדי להשבית את האצווה בספריית הלקוח, מגדירים את הערך של max_messages ל-1.
העברת הודעות באצווה ושליחה לפי סדר
כשמשתמשים בהעברה לפי סדר, אם לא מאשרים קבלה של הודעה כלשהי באצווה, כל ההודעות באצווה נשלחות מחדש, כולל אלה שנשלחו לפני ההודעה שלא אושרה.
מכסות ומגבלות על שליחת הודעות באצווה
לפני שמגדירים שליחת הודעות באצווה, כדאי להביא בחשבון את ההשפעה של גורמים כמו מכסת קצב הפרסום והגודל המקסימלי של אצווה. ספריות הלקוח ברמה הגבוהה מבטיחות שבקשות ה-Batch יישארו בטווח המגבלות שצוינו.
- גודל הבקשה המינימלי שנלקח בחשבון לצורכי עלות הוא 1,000 בייטים, גם אם גודל ההודעה בפועל קטן מ-1,000 בייטים.
- ב-Pub/Sub יש מגבלה של 10MB או 1,000 הודעות לבקשת פרסום אחת באצווה.
מידע נוסף זמין במאמר מכסות ומגבלות של Pub/Sub.
המאמרים הבאים
כדי ללמוד איך להגדיר אפשרויות פרסום מתקדמות, אפשר לעיין במאמרים הבאים: