התכונה 'פעולות שיחה' הוצאה משימוש ב-13 ביוני 2023.
כאן תוכלו לקרוא מידע נוסף על ההוצאה משימוש של 'פעולות שיחה'.
AccountLinking
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קישור חשבון מאפשר ל-Google להנחות את המשתמש להיכנס לשירותי האינטרנט של האפליקציה.
לסוגי הקישור 'כניסה באמצעות חשבון Google' ו-OAuth + כניסה באמצעות חשבון Google, Google יוצרת מזהה לקוח שמזהה את האפליקציה שלכם עבור Google ('מספר לקוח ש-Google מנפיקה לפעולות שלכם' בממשק המשתמש של המסוף). השדה הזה הוא לקריאה בלבד ואפשר לבדוק אותו על ידי מעבר לדף 'קישור חשבונות' בממשק המשתמש של המסוף. למידע נוסף: https://developers.google.com/assistant/identity/google-sign-in
הערה: בכל סוגי ההגדרות של קישור החשבונות (למעט 'כניסה באמצעות חשבון Google'), צריך להזין שם משתמש וסיסמה לחשבון הבדיקה בכתובת Settings.testing_instructions כדי שצוות הבדיקה יוכל לבדוק את האפליקציה (הם לא יהיו גלויים למשתמשים).
| ייצוג YAML |
enableAccountCreation: boolean
linkingType: enum (LinkingType)
authGrantType: enum (AuthGrantType)
appClientId: string
authorizationUrl: string
tokenUrl: string
scopes:
- string
learnMoreUrl: string
useBasicAuthHeader: boolean |
| שדות |
enableAccountCreation |
boolean
חובה. אם true, משתמשים יורשו להירשם לחשבונות חדשים באמצעות הקול. אם הערך שלו הוא false, אפשר ליצור חשבון רק באתר. צריך לבחור באפשרות הזו אם רוצים להציג את התנאים וההגבלות או לקבל את הסכמת המשתמשים במהלך ההרשמה. linkType לא יכול להיות GOOGLE_SIGN_IN כשהערך הוא false. linkType לא יכול להיות OAUTH כאשר הערך הוא true.
|
linkingType |
enum (LinkingType)
חובה. סוג הקישור שבו צריך להשתמש. מידע נוסף על סוגי הקישורים זמין בכתובת https://developers.google.com/assistant/identity.
|
authGrantType |
enum (AuthGrantType)
זה שינוי אופציונלי. מציין את סוג האימות ל-OAUTH linkType.
|
appClientId |
string
זה שינוי אופציונלי. מזהה הלקוח שהאפליקציה שלך מנפיקה ל-Google. זהו מזהה הלקוח של OAuth2 שמזהה את Google לשירות שלך. מוגדר רק כשמשתמשים ב-OAuth.
|
authorizationUrl |
string
זה שינוי אופציונלי. נקודת קצה (endpoint) לדף האינטרנט לכניסה שתומך בקוד OAuth2 או בתהליכים מרומזים. כתובת ה-URL חייבת להיות בקידוד HTTPS. מוגדר רק כשמשתמשים ב-OAuth.
|
tokenUrl |
string
זה שינוי אופציונלי. נקודת קצה מסוג OAuth2 להחלפת אסימונים. כתובת ה-URL חייבת להיות בקידוד HTTPS. ההגדרה לא מוגדרת כשמשתמשים רק ב-OAuth עם הענקת IMPLICIT כסוג הקישור. מוגדר רק כשמשתמשים ב-OAuth.
|
scopes[] |
string
זה שינוי אופציונלי. רשימת הרשאות שהמשתמש צריך להסכים להן כדי להשתמש בשירות שלכם. מוגדר רק כשמשתמשים ב-OAuth. אם מציינים את השדה הזה, יש להקפיד לציין את התנאים וההגבלות בפרטי הספרייה בקטע LocalizedSettings.terms_of_service_url.
|
learnMoreUrl |
string
זה שינוי אופציונלי. זהו דף האינטרנט בשירות שלך שבו מתוארות ההרשאות שהמשתמש מעניק ל-Google. המדיניות הזו מוגדרת רק אם משתמשים ב-OAuth ובכניסה באמצעות חשבון Google. אם מציינים את השדה הזה, יש להקפיד לציין את התנאים וההגבלות בפרטי הספרייה בקטע LocalizedSettings.terms_of_service_url.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eAccount Linking enables users to sign in to your app's web services through Google.\u003c/p\u003e\n"],["\u003cp\u003eFor Google Sign-In and OAuth linking, a Client ID is generated by Google and displayed in the Actions Console.\u003c/p\u003e\n"],["\u003cp\u003eFor all other linking types, provide test account credentials for review purposes in \u003ccode\u003eSettings.testing_instructions\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou must configure account linking settings like \u003ccode\u003eenableAccountCreation\u003c/code\u003e, \u003ccode\u003elinkingType\u003c/code\u003e, and optional OAuth parameters in your action's YAML configuration.\u003c/p\u003e\n"],["\u003cp\u003eWhen using OAuth, provide necessary information like authorization and token URLs, scopes, and optionally, a \u003ccode\u003elearnMoreUrl\u003c/code\u003e and basic authentication settings.\u003c/p\u003e\n"]]],["Account linking enables Google to guide users to sign in to an app's web services. For certain linking types, Google provides a read-only Client ID. Settings require a test account's username and password, except with Google Sign In. The YAML representation defines fields like `enableAccountCreation`, `linkingType`, `authGrantType`, and URLs for authorization and token exchange. OAuth requires specifying `appClientId`, `scopes`, and possibly `learnMoreUrl` and `useBasicAuthHeader`. The `enableAccountCreation` boolean determines if account creation is done via voice.\n"],null,["# AccountLinking\n\n- [YAML representation](#SCHEMA_REPRESENTATION)\n\nAccountLinking allows Google to guide the user to sign-in to the App's web services.\n\nFor Google Sign In and OAuth + Google Sign In linking types, Google generates a client ID identifying your App to Google (\"Client ID issued by Google to your Actions\" on Console UI). This field is read-only and can be checked by navigating to the Console UI's Account Linking page. See: \u003chttps://developers.google.com/assistant/identity/google-sign-in\u003e\n\nNote: For all account linking setting types (except for Google Sign In), you must provide a username and password for a test account in Settings.testing_instructions for the review team to review the app (they will not be visible to users).\n\n| YAML representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` enableAccountCreation: boolean linkingType: enum (/assistant/actionssdk/reference/rest/Shared.Types/LinkingType) authGrantType: enum (/assistant/actionssdk/reference/rest/Shared.Types/AuthGrantType) appClientId: string authorizationUrl: string tokenUrl: string scopes: - string learnMoreUrl: string useBasicAuthHeader: boolean ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enableAccountCreation` | `boolean` Required. If `true`, users are allowed to sign up for new accounts via voice. If `false`, account creation is only allowed on your website. Select this option if you want to display your terms of service or obtain user consents during sign-up. linkingType cannot be GOOGLE_SIGN_IN when this is `false`. linkingType cannot be OAUTH when this is `true`. |\n| `linkingType` | `enum (`[LinkingType](/assistant/actionssdk/reference/rest/Shared.Types/LinkingType)`)` Required. The linking type to use. See \u003chttps://developers.google.com/assistant/identity\u003e for further details on the linking types. |\n| `authGrantType` | `enum (`[AuthGrantType](/assistant/actionssdk/reference/rest/Shared.Types/AuthGrantType)`)` Optional. Indicates the type of authentication for OAUTH linkingType. |\n| `appClientId` | `string` Optional. Client ID issued by your App to Google. This is the OAuth2 Client ID identifying Google to your service. Only set when using OAuth. |\n| `authorizationUrl` | `string` Optional. Endpoint for your sign-in web page that supports OAuth2 code or implicit flows. URL must use HTTPS. Only set when using OAuth. |\n| `tokenUrl` | `string` Optional. OAuth2 endpoint for token exchange. URL must use HTTPS. This is not set when only using OAuth with IMPLICIT grant as the linking type. Only set when using OAuth. |\n| `scopes[]` | `string` Optional. List of permissions the user must consent to in order to use your service. Only set when using OAuth. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |\n| `learnMoreUrl` | `string` Optional. This is the web page on your service which describes the permissions the user is granting to Google. Only set if using OAuth and Google Sign In. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |\n| `useBasicAuthHeader` | `boolean` Optional. If true, allow Google to transmit client ID and secret via HTTP basic auth header. Otherwise, Google uses the client ID and secret inside the post body. Only set when using OAuth. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |"]]
