mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Google integrations: apply more reuse (#29604)
This commit is contained in:
c0ffeeca7
GitHub
parent
8921700739
commit
fa55f0a706
9
source/_includes/integrations/google_api.md
Normal file
9
source/_includes/integrations/google_api.md
Normal file
@ -0,0 +1,9 @@
|
||||
{% capture name %}{{ include.name | default: page.title }}{% endcapture %}
|
||||
{% capture domain %}{{ include.domain | default: page.ha_domain }}{% endcapture %}
|
||||
{% capture google_dev_console_link %}{{ include.google_dev_console_link | default: page.google_dev_console_link }}{% endcapture %}
|
||||
{% capture api %}{{ include.api | default: page.api }}{% endcapture %}
|
||||
{% capture api_link %}{{ include.api_link | default: page.api_link }}{% endcapture %}
|
||||
|
||||
|
||||
1. Go the Google Developers Console [{{ api }}]({{ api_link }}) {% if page.api2 %} and [{{ page.api2 }}]({{ page.api2_link }}) {% endif %}.
|
||||
2. Confirm the project and **Enable** the API.
|
||||
@ -4,7 +4,19 @@
|
||||
{% capture api %}{{ include.api | default: page.api }}{% endcapture %}
|
||||
{% capture api_link %}{{ include.api_link | default: page.api_link }}{% endcapture %}
|
||||
|
||||
{% details "Generate client ID and client Secret" %}
|
||||
|
||||
### Scenario 1: You already have credentials
|
||||
|
||||
In this case, all you need to do is enable the API:
|
||||
|
||||
1. Go the Google Developers Console [{{ api }}]({{ api_link }}) {% if page.api2 %} and [{{ page.api2 }}]({{ page.api2_link }}) {% endif %}.
|
||||
2. Confirm the project and **Enable** the API.
|
||||
3. Continue with the steps described in the [Configuration](#configuration) section.
|
||||
### Scenario 2: You do not have credentials set up yet
|
||||
|
||||
In this case, you need to generate a client secret first:
|
||||
|
||||
{% details "To generate client ID and client secret" %}
|
||||
|
||||
This section explains how to generate a client ID and client secret on
|
||||
[Google Developers Console]({{ google_dev_console_link }}).
|
||||
|
||||
22
source/_includes/integrations/google_oauth.md
Normal file
22
source/_includes/integrations/google_oauth.md
Normal file
@ -0,0 +1,22 @@
|
||||
{% capture name %}{{ include.name | default: page.title }}{% endcapture %}
|
||||
{% capture domain %}{{ include.domain | default: page.ha_domain }}{% endcapture %}
|
||||
{% capture google_dev_console_link %}{{ include.google_dev_console_link | default: page.google_dev_console_link }}{% endcapture %}
|
||||
{% capture api %}{{ include.api | default: page.api }}{% endcapture %}
|
||||
{% capture api_link %}{{ include.api_link | default: page.api_link }}{% endcapture %}
|
||||
{% capture title %}{{ include.title | default: page.title }}{% endcapture %}
|
||||
|
||||
The integration setup will next give you instructions to enter the [Application Credentials](/integrations/application_credentials/) (OAuth Client ID and Client Secret) and authorize Home Assistant to connect to {{ title }}.
|
||||
|
||||
{% details "OAuth and device authorization steps" %}
|
||||
|
||||
1. Continue through the steps of selecting the account you want to authorize.
|
||||
|
||||
2. **NOTE**: You may get a message telling you that the app has not been verified and you will need to acknowledge that in order to proceed.
|
||||
|
||||
3. You can now see the details of what you are authorizing Home Assistant to access with two options at the bottom. Select **Continue**.
|
||||
|
||||
4. The page will now display **Link account to Home Assistant?**, note **Your instance URL**. If this is not correct, refer to [My Home Assistant](/integrations/my). If everything looks good, select **Link Account**.
|
||||
|
||||
5. You may close the window, and return back to Home Assistant where you should see a **Success!** message from Home Assistant.
|
||||
|
||||
{% enddetails %}
|
||||
@ -45,8 +45,7 @@ This integration allows:
|
||||
## Prerequisites
|
||||
|
||||
You need to configure developer credentials to allow Home Assistant to access your Google Account.
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest) or [Google Sheets](/integrations/google_sheets).
|
||||
If you have already set up credentials, you can do step 1 and then skip to step 13 on the below instructions.
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest) or [Google Sheets](/integrations/google_sheets), [YouTube](/integrations/youtube), and [Google Mail](/integrations/google_mail).
|
||||
|
||||
{% include integrations/google_client_secret.md %}
|
||||
|
||||
|
||||
@ -23,29 +23,14 @@ The Google Mail integration allows you to connect your [Google Mail](https://mai
|
||||
## Prerequisites
|
||||
|
||||
You need to configure developer credentials to allow Home Assistant to access your Google Account.
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest) and [Google Sheets](/integrations/google_sheets).
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest) and [Google Sheets](/integrations/google_sheets) and [YouTube](/integrations/youtube).
|
||||
These are not the same as the one for [Google Calendar](/integrations/google).
|
||||
If you have already set up the correct credentials, you can do step 1 and then skip to step 13 on the below instructions.
|
||||
|
||||
{% include integrations/google_client_secret.md %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
The integration setup will next give you instructions to enter the [Application Credentials](/integrations/application_credentials/) (OAuth Client ID and Client Secret) and authorize Home Assistant to access your Google Mail.
|
||||
|
||||
{% details "OAuth and Device Authorization steps" %}
|
||||
|
||||
1. Continue through the steps of selecting the account you want to authorize.
|
||||
|
||||
2. **NOTE**: You may get a message telling you that the app has not been verified and you will need to acknowledge that in order to proceed.
|
||||
|
||||
3. You can now see the details of what you are authorizing Home Assistant to access with two options at the bottom. Select **Continue**.
|
||||
|
||||
4. The page will now display **Link account to Home Assistant?**, note **Your instance URL**. If this is not correct, refer to [My Home Assistant](/integrations/my). If everything looks good, select **Link Account**.
|
||||
|
||||
5. You may close the window, and return back to Home Assistant where you should see a **Success!** message from Home Assistant.
|
||||
|
||||
{% enddetails %}
|
||||
{% include integrations/google_oauth.md %}
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
||||
@ -25,35 +25,21 @@ The integration currently only has access to that one document that is created d
|
||||
## Prerequisites
|
||||
|
||||
You need to configure developer credentials to allow Home Assistant to access your Google Account.
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest), [YouTube](/integrations/youtube) and [Google Mail](/integrations/google_mail).
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest), [YouTube](/integrations/youtube), and [Google Mail](/integrations/google_mail).
|
||||
These are not the same as the one for [Google Calendar](/integrations/google).
|
||||
If you have already set up the correct credentials, you can do step 1 and then skip to step 13 on the below instructions.
|
||||
|
||||
{% include integrations/google_client_secret.md %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
The integration setup will next give you instructions to enter the [Application Credentials](/integrations/application_credentials/) (OAuth Client ID and Client Secret) and authorize Home Assistant to access your Google Sheets.
|
||||
|
||||
{% details "OAuth and Device Authorization steps" %}
|
||||
|
||||
1. Continue through the steps of selecting the account you want to authorize.
|
||||
|
||||
2. **NOTE**: You may get a message telling you that the app has not been verified and you will need to acknowledge that in order to proceed.
|
||||
|
||||
3. You can now see the details of what you are authorizing Home Assistant to access with two options at the bottom. Click **Continue**.
|
||||
|
||||
4. The page will now display *Link account to Home Assistant?*, note *Your instance URL*. If this is not correct, please refer to [My Home Assistant](/integrations/my). If everything looks good, click **Link Account**.
|
||||
|
||||
5. You may close the window, and return back to Home Assistant where you should see a *Success!* message from Home Assistant.
|
||||
|
||||
{% enddetails %}
|
||||
{% include integrations/google_oauth.md %}
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If you have an error with your credentials you can delete them in the [Application Credentials](/integrations/application_credentials/) user interface.
|
||||
|
||||
### Video Tutorial
|
||||
### Video tutorial
|
||||
|
||||
This video tutorial explains how to set up the Google Sheets integration and how you can add data from Home Assistant to a Google Sheet.
|
||||
|
||||
<lite-youtube videoid="hgGMgoxLYwo" videotitle="How to use Google Sheets in Home Assistant - TUTORIAL" posterquality="maxresdefault"></lite-youtube>
|
||||
|
||||
@ -26,29 +26,14 @@ For every channel you add, it will create sensors for:
|
||||
## Prerequisites
|
||||
|
||||
To be able to configure the integration, you need to have a YouTube channel.
|
||||
How to create one can be found [here](https://support.google.com/youtube/answer/1646861).
|
||||
To learn how to create one, refer to the [YouTube documentation](https://support.google.com/youtube/answer/1646861).
|
||||
|
||||
You need to configure developer credentials to allow Home Assistant to access your Google Account.
|
||||
These credentials are the same as the ones for [Nest](/integrations/nest), [Google Mail](/integrations/google_mail) and [Google Sheets](/integrations/google_sheets).
|
||||
These are not the same as the one for [Google Calendar](/integrations/google).
|
||||
If you have already set up the correct credentials, you can do step 1 and then skip to step 13 on the below instructions.
|
||||
|
||||
{% include integrations/google_client_secret.md %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
The integration setup will next give you instructions to enter the [Application Credentials](/integrations/application_credentials/) (OAuth Client ID and Client Secret) and authorize Home Assistant to connect to YouTube.
|
||||
|
||||
{% details "OAuth and Device Authorization steps" %}
|
||||
|
||||
1. Continue through the steps of selecting the account you want to authorize.
|
||||
|
||||
2. **NOTE**: You may get a message telling you that the app has not been verified and you will need to acknowledge that in order to proceed.
|
||||
|
||||
3. You can now see the details of what you are authorizing Home Assistant to access with two options at the bottom. Select **Continue**.
|
||||
|
||||
4. The page will now display **Link account to Home Assistant?**, note **Your instance URL**. If this is not correct, refer to [My Home Assistant](/integrations/my). If everything looks good, select **Link Account**.
|
||||
|
||||
5. You may close the window, and return back to Home Assistant where you should see a **Success!** message from Home Assistant.
|
||||
|
||||
{% enddetails %}
|
||||
{% include integrations/google_oauth.md %}
|
||||
|
||||
@ -6,19 +6,24 @@ title: Assist - Talking to Home Assistant
|
||||
|
||||
Assist is our feature to allow you to control Home Assistant using natural language. It is built on top of an open voice foundation and powered by knowledge provided by our community.
|
||||
|
||||
Assist is available to use on most platforms that can interface with Home Assistant. Look for the Assist icon <img src='/images/assist/assist-icon.svg' alt='Assist icon' style='height: 32px' class='no-shadow'>:
|
||||
|
||||
The easiest way to get started with Assist is probably by using it on your phone.
|
||||
|
||||
- Inside the Home Assistant app in the top-right corner, select the Assist icon.
|
||||
- On Apple devices via [Siri and Assist shortcuts](/voice_control/apple).
|
||||
- On Android phones as the default [digital assistant or home screen shortcut](/voice_control/android)
|
||||
- On Wear OS watches as the default digital assistant or using [Assist tile or complication](//voice_control/android/#assist-on-wear-os).
|
||||
|
||||
|
||||
You can also set a wake word, so that Assist starts
|
||||
|
||||
_Want to use Home Assistant with Google Assistant or Amazon Alexa? Get started with [Home Assistant Cloud](https://www.nabucasa.com/config/)._
|
||||
|
||||
With Assist, you can use the [built-in sentences](/voice_control/builtin_sentences) to control entities and areas, or [create your own](/voice_control/custom_sentences).
|
||||
|
||||
[List of supported languages.](https://developers.home-assistant.io/docs/voice/intent-recognition/supported-languages)
|
||||
|
||||
Assist is available to use on most platforms that can interface with Home Assistant. Look for the Assist icon <img src='/images/assist/assist-icon.svg' alt='Assist icon' style='height: 32px' class='no-shadow'>:
|
||||
|
||||
- Inside the Home Assistant app in the top-right corner
|
||||
- On Apple devices via [Siri and Assist shortcuts](/voice_control/apple)
|
||||
- On Android phones as the default digital assistant or home screen shortcut
|
||||
- On Wear OS watches as the default digital assistant or using [Assist tile or complication](/voice_control/android)
|
||||
|
||||
Did Assist not understand your sentence? [Contribute them.](https://developers.home-assistant.io/docs/voice/intent-recognition/)
|
||||
|
||||
The Assist icon doesn't show up? Make sure the [conversation](/integrations/conversation/) integration is enabled. If you use YAML for configuration and have removed `default_config:`, the conversation integration may not be included in the config file.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user