Publishing GVA action

[中文版本]

Certify and Publish GVA action

When GVA action is created and configured, it can be enabled with the admin account of the action. This is the account using which the GVA action was created and configured. The skill can be shared with limited users for a limited period using beta testing feature.

To make the GVA action publicly available, it is required to certify and publish the action. After testing your action with your firmware and ensuring it is working as expected, you can submit the action for certification.

This section provides the steps to certify and publish the GVA action in the Google Actions store.

Pre-requisites

Adding the logo and authorization statement to the Oauth Page

For google action certification, it is required that the Oauth Page mentions the Authorization statement - "By signing in, you are authorizing Google to control your devices". Follow below steps to include the Authorization statement to your Google Action Oauth page.

  1. Keep an image ready with your logo and authorization statement - "By signing in, you are authorizing Google to control your devices". Like:

  1. The sign-in page will finally look like the below image.

  1. Login to AWS Console. Go to Cognito service page. Switch to new console experience if you can see the option.
  2. Click on "User Pools".
  3. Click on "rainmaker-user-email-mobile-pool".
  4. In the "App Integration" section, scroll down and select "esp-rainmaker-google-action".
  5. Scroll down to "Hosted UI customization".
  6. Upload the image in logo field of UI customization.
  7. Scroll up and click on "view Hosted UI" to check if the Oauth Page now includes the logo.

Launch Hosted UI

  1. Try account linking for your action using Google Home app, ensure that Login page shows the logo along with authorization statement.

Required details

Keep the following details ready before we publish the skill.

  • Privacy Policy and Terms of use URL for your action.
  • Brand Name - the brand name of your product.
  • Link(s) to the product on the market.
  • Short description - one-line description of your action.
  • The full description - Description that users will see for your action. The description should give details about what can be done using the action.
  • Keywords - Simple search words that relate to or describe this action.
  • Example phrases (examples of supported voice commands).
  • Public name of your GVA action.
  • A test account with at least one test device.
  • OAuth page - the screenshot of your OAuth page that will be visible when the user will link the account with your action.
  • Small logo(icon) - requirements for a small action logo are:
  • Round logo
  • 192 x 192 pixels
  • A transparent background, using PNG format
  • If your logo is white, a colored border must be added
  • Large banner image - requirements are:
  • 1920x1080 pixels.
  • A transparent background, using PNG format
  • App Logo (icon) - requirements are:
  • Round logo
  • 144 x 144 pixels
  • A transparent background, using PNG format
  • If your logo is white, a colored border must be added
  • Contact details - Developer name and email. This information will be used by the Google team to contact you regarding the certification status of your action.
  • Developer details.

Getting Test Suite Results

  1. Keep your test device or development board online.
  2. Ensure that the above test node is associated with a test user and test user has completed the account linking from the Google Home app.
  3. Go to Google actions console and go to your smart home action.
  4. Select the "Test" tab from the menu.
  5. Click on the "Go to test suite" button.
  6. Sign in using your Google account and enter the project-id for your google action.
  7. Your devices will be listed. Select your test device.
  8. Scroll down and Click on "Configure test environment".
  9. Start the tests.
  10. It will take some time to complete the test suite.
  11. Once the test suite is completed, ensure that there are not any "Failed" test cases.
  12. If there are no failed test cases, you can click on the "Results and Submission" button.
  13. Download the Result file on your computer.
  14. The Result file will need to be submitted while filling out the certification request form.

Filling in the deployment details

  1. Login to the Google actions console and open the smart home action which is to be certified.
  2. Go to the "Deploy" tab from the menu.
  3. Go to the "Directory Information" section.
  4. Fill out all the details on the page and Save the changes.
  5. Go to the "Company Details" section
  6. Fill out the required details and Save the changes.

  1. Click on the "Certification Request Form" option.

  2. Fill out the certification request form.

    Adding the answers for common required questions in the Google action Certification Request form:

    1. Is this action tied to a commercial product? -> Yes.
    2. Does your action implement SCENE trait only? -> No.
    3. Type of Submission -> Cloud.
    4. Traits that require manual testing -> Select "I have no traits that require manual testing" if your device can report state, choose "Command Only" otherwise.
    5. Have you implemented Notifications to your devices, and requires certification -> No.
    6. If you cannot implement notifications on compatible traits, please specify an ETA when it can be implemented. -> Keep this empty, if your device is not a sensor.
    7. Have you added app flip to your action, and need that to be certified? -> No.
    8. If no, please specify an ETA if you have one. -> Keep empty.
    9. Updating information that require manual verification -> Keep empty.
    10. UL Certificate -> Skip uploading this, if your device is not a cooking appliance.

  3. After the certification request form is submitted, submit the action for release.

  4. Go to the "Release" option on the Actions console.

  5. Click on "Start Release".

  6. Select channel "production".

  7. Tick on the pre-launch checklist items and submit the action for rollout.

  8. You can optionally link your website to your action, in "Brand verification" section.

  9. You will receive the certification status update from the Google action certification team in 5-10 days.

← Publishing Alexa skillUpgrades →