קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מופיעה סקירה כללית על השימוש ב-Google Chat API ועל מסמכי העיון שלו.
ל-Google Chat API יש ממשקי gRPC ו-REST, וגם ספריות לקוח שתומכות בשניהם. לחלופין, אם ספריות הלקוח שסופקו לא מתאימות לצרכים שלכם, אתם יכולים לכתוב ספריות לקוח משלכם שמשתמשות בממשק gRPC או REST.
ספריות לקוח
הדרך המומלצת לרוב המפתחים לקרוא ל-Google Chat API היא באמצעות ספריות הלקוח של Cloud שנתמכות באופן רשמי בשפה המועדפת עליכם, כמו Python, Java או Node.js.
אם אתם כותבים קוד באמצעות Google Apps Script, אתם יכולים להשתמש בשירות המתקדם של Chat במקום להתקין ספריית לקוח.
סוג, שיטה ושמות שדות
הסוג, השיטה ושמות השדות של Google Chat API משתנים בהתאם לשימוש בספריות לקוח, ב-gRPC או ב-REST:
ספריות הלקוח ב-Cloud מסודרות לפי שירותי gRPC והשיטות שלהם.
ספריות הלקוח של Google API מסודרות כשירותים שמכילים אובייקטים או מחלקות שתואמים למשאבי REST, שמכילים גם שיטות תואמות.
פרוטוקול gRPC מסודר לפי שירותים והשיטות שלהם.
ממשק REST מסודר לפי היררכיות של משאבים והשיטות שלהם.
שמות השדות ב-gRPC הם בפורמט snake case.
שמות השדות ב-REST הם בפורמט CamelCase, אבל שירות ה-API יקבל גם פורמט CamelCase וגם פורמט SnakeCase.
שמות השדות בספריית הלקוח הם באותיות רישיות בתחילת כל מילה, בשיטת Camel Case או בשיטת Snake Case, בהתאם לשם שמתאים לשפה.
מאגרי אחסון לפרוטוקולים
בין אם אתם משתמשים בספריות לקוח, ב-REST או ב-gRPC, השירות הבסיסי מוגדר באמצעות מאגרי פרוטוקולים. באופן ספציפי, השירות משתמש ב-proto3.
בנוסף, כשקוראים ל-REST API, יכול להיות ששדות יחסרו בתגובת JSON בגלל התנהגות ערך ברירת המחדל של מאגרי פרוטוקולים. הערכים בשדות האלה הם ערכי ברירת המחדל, ולכן הם לא נכללים בתגובה.
גרסאות API
הגרסאות הבאות של ה-API זמינות:
v1: יציבה.
תצוגה מקדימה למפתחים
יכול להיות שתראו במסמכים שיטות API או שדות שזמינים רק דרך תוכנית התצוגה המקדימה למפתחים. כדי לבדוק את התכונות החדשות בגרסת הטרום-השקה, לראות תצוגה מקדימה שלהן ולשלוח משוב, אפשר להצטרף לתוכנית טרום-ההשקה למפתחים.
[[["התוכן קל להבנה","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-07-25 (שעון 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"]]
