From 3573ab4a3ede0f0498048921d7e5a4ca5e04506a Mon Sep 17 00:00:00 2001
From: Yoshi Automation Bot <yoshi-automation@google.com>
Date: Tue, 27 Jul 2021 14:06:42 -0700
Subject: [PATCH] chore: regenerate README (#149)

This PR was generated using Autosynth. :rainbow:


<details><summary>Log from Synthtool</summary>

```
2021-07-27 20:57:29,854 synthtool [DEBUG] > Executing /root/.cache/synthtool/java-retail/.github/readme/synth.py.
On branch autosynth-readme
nothing to commit, working tree clean
2021-07-27 20:57:31,111 synthtool [DEBUG] > Wrote metadata to .github/readme/synth.metadata/synth.metadata.

```
</details>

Full log will be available here:
https://source.cloud.google.com/results/invocations/f46333b1-7577-46f2-a38b-3de4f41856f1/targets

- [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.)
---
 .github/readme/synth.metadata/synth.metadata |  4 ++--
 README.md                                    | 13 +++++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/.github/readme/synth.metadata/synth.metadata b/.github/readme/synth.metadata/synth.metadata
index 3bda7a93..f44646e4 100644
--- a/.github/readme/synth.metadata/synth.metadata
+++ b/.github/readme/synth.metadata/synth.metadata
@@ -4,14 +4,14 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/java-retail.git",
-        "sha": "d1574f0025e9bd8e2048dbfb6f5a45441cb1d1cb"
+        "sha": "9fa292efe3875960cc1af0c19481d8d3b0556d58"
       }
     },
     {
       "git": {
         "name": "synthtool",
         "remote": "https://github.com/googleapis/synthtool.git",
-        "sha": "4124d245133c0f740ac5e6fa2e7daeba327f1297"
+        "sha": "3d32990b6f4b57be77455e3ca89e6e21cd0c06b3"
       }
     }
   ]
diff --git a/README.md b/README.md
index 8ea42a9d..a84419a6 100644
--- a/README.md
+++ b/README.md
@@ -8,11 +8,13 @@ Java idiomatic client for [Cloud Retail][product-docs].
 - [Product Documentation][product-docs]
 - [Client Library Documentation][javadocs]
 
+
 ## Quickstart
 
 
 If you are using Maven, add this to your pom.xml file:
 
+
 ```xml
 <dependency>
   <groupId>com.google.cloud</groupId>
@@ -23,11 +25,13 @@ If you are using Maven, add this to your pom.xml file:
 ```
 
 If you are using Gradle without BOM, add this to your dependencies
+
 ```Groovy
 compile 'com.google.cloud:google-cloud-retail:1.1.2'
 ```
 
 If you are using SBT, add this to your dependencies
+
 ```Scala
 libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "1.1.2"
 ```
@@ -36,6 +40,10 @@ libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "1.1.2"
 
 See the [Authentication][authentication] section in the base directory's README.
 
+## Authorization
+
+The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Cloud Retail APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Cloud Retail API calls.
+
 ## Getting Started
 
 ### Prerequisites
@@ -122,6 +130,7 @@ and on [google-cloud-java][g-c-j].
 This library follows [Semantic Versioning](http://semver.org/).
 
 
+
 ## Contributing
 
 
@@ -133,6 +142,7 @@ Please note that this project is released with a Contributor Code of Conduct. By
 this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
 information.
 
+
 ## License
 
 Apache 2.0 - See [LICENSE][license] for more information.
@@ -165,6 +175,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-retail.svg
 [maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-retail&core=gav
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
+[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
+[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
+[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
 [developer-console]: https://console.developers.google.com/
 [create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
 [cloud-sdk]: https://cloud.google.com/sdk/