feat: added Telephony Gateway DTMF events (#279)

docs: added locations in resource name formats
docs: wording updates for tiers

PiperOrigin-RevId: 331627223

Source-Author: Google APIs <noreply@google.com>
Source-Date: Mon Sep 14 14:16:43 2020 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 791be5a40033c18034afed50232daad6bdc8cf3e
Source-Link: googleapis/googleapis@791be5a

Author: yoshi-automation

google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2beta1/AgentsClient.java

@@ -184,7 +184,8 @@ public final OperationsClient getOperationsClient() {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to fetch is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Agent getAgent(ProjectName parent) {
@@ -207,7 +208,8 @@ public final Agent getAgent(ProjectName parent) {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to fetch is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Agent getAgent(LocationName parent) {
@@ -230,7 +232,8 @@ public final Agent getAgent(LocationName parent) {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to fetch is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Agent getAgent(String parent) {
@@ -363,7 +366,8 @@ public final UnaryCallable<SetAgentRequest, Agent> setAgentCallable() {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to delete is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final void deleteAgent(ProjectName parent) {
@@ -388,7 +392,8 @@ public final void deleteAgent(ProjectName parent) {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to delete is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final void deleteAgent(LocationName parent) {
@@ -413,7 +418,8 @@ public final void deleteAgent(LocationName parent) {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to delete is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final void deleteAgent(String parent) {
@@ -485,7 +491,7 @@ public final UnaryCallable<DeleteAgentRequest, Empty> deleteAgentCallable() {
    * </code></pre>
    *
    * @param parent Required. The project to list agents from. Format: `projects/&lt;Project ID or
-   *     '-'&gt;`.
+   *     '-'&gt;` or `projects/&lt;Project ID or '-'&gt;/locations/&lt;Location ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final SearchAgentsPagedResponse searchAgents(ProjectName parent) {
@@ -515,7 +521,7 @@ public final SearchAgentsPagedResponse searchAgents(ProjectName parent) {
    * </code></pre>
    *
    * @param parent Required. The project to list agents from. Format: `projects/&lt;Project ID or
-   *     '-'&gt;`.
+   *     '-'&gt;` or `projects/&lt;Project ID or '-'&gt;/locations/&lt;Location ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final SearchAgentsPagedResponse searchAgents(LocationName parent) {
@@ -545,7 +551,7 @@ public final SearchAgentsPagedResponse searchAgents(LocationName parent) {
    * </code></pre>
    *
    * @param parent Required. The project to list agents from. Format: `projects/&lt;Project ID or
-   *     '-'&gt;`.
+   *     '-'&gt;` or `projects/&lt;Project ID or '-'&gt;/locations/&lt;Location ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final SearchAgentsPagedResponse searchAgents(String parent) {
@@ -659,7 +665,8 @@ public final UnaryCallable<SearchAgentsRequest, SearchAgentsResponse> searchAgen
    * </code></pre>
    *
    * @param parent Required. The project that the agent to train is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -686,7 +693,8 @@ public final OperationFuture<Empty, Struct> trainAgentAsync(ProjectName parent)
    * </code></pre>
    *
    * @param parent Required. The project that the agent to train is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -713,7 +721,8 @@ public final OperationFuture<Empty, Struct> trainAgentAsync(LocationName parent)
    * </code></pre>
    *
    * @param parent Required. The project that the agent to train is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -816,7 +825,8 @@ public final UnaryCallable<TrainAgentRequest, Operation> trainAgentCallable() {
    * </code></pre>
    *
    * @param parent Required. The project that the agent to export is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -846,7 +856,8 @@ public final OperationFuture<ExportAgentResponse, Struct> exportAgentAsync(Proje
    * </code></pre>
    *
    * @param parent Required. The project that the agent to export is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -876,7 +887,8 @@ public final OperationFuture<ExportAgentResponse, Struct> exportAgentAsync(Locat
    * </code></pre>
    *
    * @param parent Required. The project that the agent to export is associated with. Format:
-   *     `projects/&lt;Project ID&gt;`.
+   *     `projects/&lt;Project ID&gt;` or `projects/&lt;Project ID&gt;/locations/&lt;Location
+   *     ID&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(