AccountLinking
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
AccountLinking memungkinkan Google memandu pengguna untuk login ke layanan web Aplikasi.
Untuk jenis penautan Login dengan Google dan OAuth + Login dengan Google, Google membuat client ID yang mengidentifikasi Aplikasi Anda ke Google ("Client ID yang dikeluarkan oleh Google untuk Actions Anda" di UI Konsol). Kolom ini bersifat hanya baca dan dapat diperiksa dengan membuka halaman Penautan Akun di UI Konsol. Lihat: https://developers.google.com/assistant/identity/google-sign-in
Catatan: Untuk semua jenis setelan penautan akun (kecuali Login dengan Google), Anda harus memberikan nama pengguna dan sandi untuk akun pengujian di Settings.testing_instructions agar tim peninjau dapat meninjau aplikasi (tidak akan dapat dilihat oleh pengguna).
| Representasi YAML |
enableAccountCreation: boolean
linkingType: enum (LinkingType)
authGrantType: enum (AuthGrantType)
appClientId: string
authorizationUrl: string
tokenUrl: string
scopes:
- string
learnMoreUrl: string
useBasicAuthHeader: boolean |
| Kolom |
enableAccountCreation |
boolean
Wajib. Jika true, pengguna diizinkan mendaftar untuk akun baru melalui suara. Jika false, pembuatan akun hanya diizinkan di situs Anda. Pilih opsi ini jika Anda ingin menampilkan persyaratan layanan atau mendapatkan izin pengguna saat mendaftar. linkingType tidak boleh berupa GOOGLE_SIGN_IN jika ini adalah false. linkingType tidak boleh OAUTH jika ini adalah true.
|
linkingType |
enum (LinkingType)
Wajib. Jenis penautan yang akan digunakan. Lihat https://developers.google.com/assistant/identity untuk mengetahui detail selengkapnya tentang jenis penautan.
|
authGrantType |
enum (AuthGrantType)
Opsional. Menunjukkan jenis autentikasi untuk OAUTH linkingType.
|
appClientId |
string
Opsional. Client ID yang dikeluarkan oleh Aplikasi Anda ke Google. Ini adalah Client ID OAuth2 yang mengidentifikasi Google ke layanan Anda. Hanya disetel saat menggunakan OAuth.
|
authorizationUrl |
string
Opsional. Endpoint untuk halaman web login Anda yang mendukung kode OAuth2 atau alur implisit. URL harus menggunakan HTTPS. Hanya disetel saat menggunakan OAuth.
|
tokenUrl |
string
Opsional. Endpoint OAuth2 untuk pertukaran token. URL harus menggunakan HTTPS. Opsi ini tidak ditetapkan jika hanya menggunakan OAuth dengan pemberian IMPLICIT sebagai jenis penautan. Hanya disetel saat menggunakan OAuth.
|
scopes[] |
string
Opsional. Daftar izin yang harus disetujui pengguna untuk menggunakan layanan Anda. Hanya disetel saat menggunakan OAuth. Pastikan untuk menyediakan Persyaratan Layanan dalam informasi direktori di bagian LocalizedSettings.terms_of_service_url jika menentukan kolom ini.
|
learnMoreUrl |
string
Opsional. Ini adalah halaman web di layanan Anda yang menjelaskan izin yang diberikan pengguna kepada Google. Hanya tetapkan jika menggunakan OAuth dan Login dengan Google. Pastikan untuk menyediakan Persyaratan Layanan dalam informasi direktori di bagian LocalizedSettings.terms_of_service_url jika menentukan kolom ini.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
