קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה נספק סקירה כללית על השימוש ב-Google Chat API ועל מסמכי העזרה שלו.
ל-Google Chat API יש ממשקים של gRPC ושל REST, וגם ספריות לקוח שתומכות בשניהם. אם ספריות הלקוח שסופקו לא עומדות בצרכים שלכם, תוכלו לכתוב ספריות לקוח משלכם שמשתמשות בממשק gRPC או REST.
ספריות לקוח
הדרך המומלצת לרוב המפתחים לבצע קריאה ל-Google Chat API היא באמצעות ספריות הלקוח של Cloud הנתמכות באופן רשמי בשפה המועדפת עליכם, כמו Python, Java או Node.js.
אם אתם כותבים קוד ב-Google Apps Script, השתמשו בשירות Chat המתקדם במקום להתקין ספריית לקוח.
שמות של טיפוסים, שיטות ושדות
בהתאם לשימוש בספריות לקוח, ב-gRPC או ב-REST, יש הבדלים מסוימים בסוג, בשיטה ובשמות השדות של Google Chat API:
ספריות הלקוח ב-Cloud מסודרות לפי שירותי gRPC והשיטות שלהם.
ספריות הלקוח של Google API מסודרות כשירותים שמכילים אובייקטים או שיעורים שתואמים למשאבי REST, שגם הם מכילים שיטות תואמות.
ה-gRPC מסודר לפי שירותים והשיטות שלהם.
ה-REST מחולק לפי היררכיות של משאבים והשיטות שלהם.
בשמות השדות של gRPC נעשה שימוש בקו תחתון בין המילים.
שמות השדות ב-REST נכתבים באותיות רישיות עם תחילית קטנה (camel case), אבל שירות ה-API יקבל גם שמות באותיות רישיות עם תחילית גדולה (snake case).
שמות השדות בספריית הלקוח נכתבים באותיות רישיות, באותיות קטנות או באותיות קטנות עם מקף, בהתאם לשפה.
מאגרי אחסון לפרוטוקולים
בין שאתם משתמשים בספריות לקוח, ב-REST או ב-gRPC, השירות הבסיסי מוגדר באמצעות Protocol Buffers. באופן ספציפי, השירות משתמש ב-proto3.
בנוסף, כשקוראים ל-API ל-REST, התנהגות ערך ברירת המחדל של מאגרי הפרוטוקולים עלולה לגרום לשדות חסרים בתגובה בפורמט JSON. השדות האלה מוגדרים לערך ברירת המחדל, ולכן הם לא נכללים בתגובה.
גרסאות API
אלה גרסאות ה-API הזמינות:
v1: יציבה.
תצוגה מקדימה למפתחים
במסמכי העזרה עשויים להופיע שדות או שיטות API שזמינים רק דרך תוכנית Developer Preview. כדי לבדוק את התכונות החדשות בגרסת הבטא, לקבל גישה לתצוגה המקדימה שלהן ולשלוח משוב, תוכלו להצטרף לתוכנית הבטא למפתחים.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-02-16 (שעון UTC)."],[[["This page offers guidance on utilizing the Google Chat API and navigating its reference documentation, including gRPC and REST interfaces."],["Developers are encouraged to use the provided client libraries for Python, Java, Node.js, or the Advanced Chat service for Google Apps Script."],["Type, method, and field names may vary slightly depending on whether you are using client libraries, gRPC, or REST, with details provided on their respective conventions."],["The Google Chat API is built upon protocol buffers, specifically proto3, which may require a basic understanding for certain request and response fields."],["Stable API version v1 is currently available, with access to developer preview features obtainable through the Developer Preview Program."]]],["The Google Chat API offers gRPC and REST interfaces, with corresponding client libraries or the option to create custom ones. Developers can use Cloud Client Libraries, or the Advanced Chat service with Google Apps Script. Type, method, and field names vary across libraries, gRPC, and REST. The API relies on protocol buffers (proto3), which can impact JSON responses due to default value behavior. The current stable version is v1, with a Developer Preview program for testing new features.\n"]]
