diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/attachments.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/attachments.ex deleted file mode 100644 index 203bfecd99..0000000000 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/attachments.ex +++ /dev/null @@ -1,103 +0,0 @@ -# Copyright 2019 Google LLC -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -# NOTE: This file is auto generated by the elixir code generator program. -# Do not edit this file manually. - -defmodule GoogleApi.CloudSupport.V2beta.Api.Attachments do - @moduledoc """ - API calls for all endpoints tagged `Attachments`. - """ - - alias GoogleApi.CloudSupport.V2beta.Connection - alias GoogleApi.Gax.{Request, Response} - - @library_version Mix.Project.config() |> Keyword.get(:version, "") - - @doc """ - Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. - - ## Parameters - - * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of the case to which attachment should be attached. - * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. - * `optional_params` (*type:* `keyword()`) - Optional parameters - * `:"$.xgafv"` (*type:* `String.t`) - V1 error format. - * `:access_token` (*type:* `String.t`) - OAuth access token. - * `:alt` (*type:* `String.t`) - Data format for response. - * `:callback` (*type:* `String.t`) - JSONP - * `:fields` (*type:* `String.t`) - Selector specifying which fields to include in a partial response. - * `:key` (*type:* `String.t`) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. - * `:oauth_token` (*type:* `String.t`) - OAuth 2.0 token for the current user. - * `:prettyPrint` (*type:* `boolean()`) - Returns response with indentations and line breaks. - * `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. - * `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart"). - * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). - * `:body` (*type:* `GoogleApi.CloudSupport.V2beta.Model.CreateAttachmentRequest.t`) - - * `opts` (*type:* `keyword()`) - Call options - - ## Returns - - * `{:ok, %GoogleApi.CloudSupport.V2beta.Model.Attachment{}}` on success - * `{:error, info}` on failure - """ - @spec cloudsupport_attachments_create( - Tesla.Env.client(), - String.t(), - String.t(), - keyword(), - keyword() - ) :: - {:ok, GoogleApi.CloudSupport.V2beta.Model.Attachment.t()} - | {:ok, Tesla.Env.t()} - | {:ok, list()} - | {:error, any()} - def cloudsupport_attachments_create( - connection, - v2beta_id, - v2beta_id1, - optional_params \\ [], - opts \\ [] - ) do - optional_params_config = %{ - :"$.xgafv" => :query, - :access_token => :query, - :alt => :query, - :callback => :query, - :fields => :query, - :key => :query, - :oauth_token => :query, - :prettyPrint => :query, - :quotaUser => :query, - :uploadType => :query, - :upload_protocol => :query, - :body => :body - } - - request = - Request.new() - |> Request.method(:post) - |> Request.url("/v2beta/{v2betaId}/{v2betaId1}/attachments", %{ - "v2betaId" => URI.encode(v2beta_id, &URI.char_unreserved?/1), - "v2betaId1" => URI.encode(v2beta_id1, &URI.char_unreserved?/1) - }) - |> Request.add_optional_params(optional_params_config, optional_params) - |> Request.library_version(@library_version) - - connection - |> Connection.execute(request) - |> Response.decode(opts ++ [struct: %GoogleApi.CloudSupport.V2beta.Model.Attachment{}]) - end -end diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/case_classifications.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/case_classifications.ex index f763627173..4db163768d 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/case_classifications.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/case_classifications.ex @@ -26,7 +26,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.CaseClassifications do @library_version Mix.Project.config() |> Keyword.get(:version, "") @doc """ - Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy, separated by " > ". For example "Technical Issue > Compute > Compute Engine". + Retrieve valid classifications to use when creating a support case. Classifications are hierarchical. Each classification is a string containing all levels of the hierarchy separated by `" > "`. For example, `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by this endpoint are valid for at least six months. When a classification is deactivated, this endpoint immediately stops returning it. After six months, `case.create` requests using the classification will fail. EXAMPLES: cURL: ```shell curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ``` Python: ```python import googleapiclient.discovery supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version="v2", discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=v2", ) request = supportApiService.caseClassifications().search( query='display_name:"*Compute Engine*"' ) print(request.execute()) ``` ## Parameters @@ -43,9 +43,11 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.CaseClassifications do * `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. * `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart"). * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). - * `:pageSize` (*type:* `integer()`) - The maximum number of cases fetched with each request. + * `:pageSize` (*type:* `integer()`) - The maximum number of classifications fetched with each request. * `:pageToken` (*type:* `String.t`) - A token identifying the page of results to return. If unspecified, the first page is retrieved. - * `:query` (*type:* `String.t`) - An expression written in the Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out. + * `:"product.productLine"` (*type:* `String.t`) - The Product Line of the Product. + * `:"product.productSubline"` (*type:* `String.t`) - The Product Subline of the Product, such as "Maps Billing". + * `:query` (*type:* `String.t`) - An expression used to filter case classifications. If it's an empty string, then no filtering happens. Otherwise, case classifications will be returned that match the filter. * `opts` (*type:* `keyword()`) - Call options ## Returns @@ -73,6 +75,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.CaseClassifications do :upload_protocol => :query, :pageSize => :query, :pageToken => :query, + :"product.productLine" => :query, + :"product.productSubline" => :query, :query => :query } diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/cases.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/cases.ex index bcd8b5a8c1..7cb9757fc8 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/cases.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/cases.ex @@ -26,12 +26,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do @library_version Mix.Project.config() |> Keyword.get(:version, "") @doc """ - Close the specified case. + Close a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \\ --request POST \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$case:close" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().close( name="projects/some-project/cases/43595344" ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The fully qualified name of the case resource to be closed. + * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The name of the case to close. * `v2beta_id1` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -106,12 +106,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Create a new case and associate it with the given Cloud resource. The case object must have the following fields set: display_name, description, classification, and severity. + Create a new case and associate it with a parent. It must have the following fields set: `display_name`, `description`, `classification`, and `priority`. If you're just testing the API and don't want to route your case to an agent, set `testCase=true`. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \\ --request POST \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --header 'Content-Type: application/json' \\ --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "bar@domain.com" ], "testCase": true, "priority": "P3" }' \\ "https://cloudsupport.googleapis.com/v2/$parent/cases" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().create( parent="projects/some-project", body={ "displayName": "A Test Case", "description": "This is a test case.", "testCase": True, "priority": "P2", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, }, ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the Cloud resource under which the case should be created. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the parent under which the case should be created. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters * `:"$.xgafv"` (*type:* `String.t`) - V1 error format. @@ -182,12 +182,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Escalate a case. Escalating a case will initiate the Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations. + Escalate a case, starting the Google Cloud Support escalation management process. This operation is only available for some support services. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which ones let you do that. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \\ --request POST \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --header "Content-Type: application/json" \\ --data '{ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation." } }' \\ "https://cloudsupport.googleapis.com/v2/$case:escalate" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().escalate( name="projects/some-project/cases/43595344", body={ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation.", }, }, ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The fully qualified name of the Case resource to be escalated. + * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The name of the case to be escalated. * `v2beta_id1` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -262,12 +262,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Retrieve the specified case. + Retrieve a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/16033687" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$case" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().get( name="projects/some-project/cases/43595344", ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The fully qualified name of a case to be retrieved. + * `v2beta_id` (*type:* `String.t`) - Part of `name`. Required. The full name of a case to be retrieved. * `v2beta_id1` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -340,12 +340,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Retrieve all cases under the specified parent. Note: Listing cases under an Organization returns only the cases directly parented by that organization. To retrieve all cases under an organization, including cases parented by projects under that organization, use `cases.search`. + Retrieve all cases under a parent, but not its children. For example, listing cases under an organization only returns the cases that are directly parented by that organization. To retrieve cases under an organization and its projects, use `cases.search`. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$parent/cases" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().list(parent="projects/some-project") print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The fully qualified name of parent resource to list cases under. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of a parent to list cases under. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters * `:"$.xgafv"` (*type:* `String.t`) - V1 error format. @@ -359,9 +359,10 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do * `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. * `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart"). * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). - * `:filter` (*type:* `String.t`) - An expression written in filter language. If non-empty, the query returns the cases that match the filter. Else, the query doesn't filter the cases. Filter expressions use the following fields with the operators equals (`=`) and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. Examples: - `state=CLOSED` - `state=OPEN AND creator.email="tester@example.com"` - `state=OPEN AND (priority=P0 OR priority=P1)` + * `:filter` (*type:* `String.t`) - An expression used to filter cases. If it's an empty string, then no filtering happens. Otherwise, the endpoint returns the cases that match the filter. Expressions use the following fields separated by `AND` and specified with `=`: - `state`: Can be `OPEN` or `CLOSED`. - `priority`: Can be `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. EXAMPLES: - `state=CLOSED` - `state=OPEN AND creator.email="tester@example.com"` - `state=OPEN AND (priority=P0 OR priority=P1)` * `:pageSize` (*type:* `integer()`) - The maximum number of cases fetched with each request. Defaults to 10. * `:pageToken` (*type:* `String.t`) - A token identifying the page of results to return. If unspecified, the first page is retrieved. + * `:productLine` (*type:* `String.t`) - The product line for which to request cases for. If unspecified, only Google Cloud cases will be returned. * `opts` (*type:* `keyword()`) - Call options ## Returns @@ -395,7 +396,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do :upload_protocol => :query, :filter => :query, :pageSize => :query, - :pageToken => :query + :pageToken => :query, + :productLine => :query } request = @@ -414,7 +416,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Update the specified case. Only a subset of fields (display_name, description, time_zone, subscriber_email_addresses, related_resources, severity, priority, primary_contact, and labels) can be updated. + Update a case. Only some fields can be updated. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \\ --request PATCH \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --header "Content-Type: application/json" \\ --data '{ "priority": "P1" }' \\ "https://cloudsupport.googleapis.com/v2/$case?updateMask=priority" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().patch( name="projects/some-project/cases/43112854", body={ "displayName": "This is Now a New Title", "priority": "P2", }, ) print(request.execute()) ``` ## Parameters @@ -434,7 +436,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do * `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. * `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart"). * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). - * `:updateMask` (*type:* `String.t`) - A field that represents attributes of a case object that should be updated as part of this request. Supported values are severity, display_name, and subscriber_email_addresses. If no fields are specified, all supported fields will be updated. WARNING: If you do not provide a field mask then you may accidentally clear some fields. For example, if you leave field mask empty and do not provide a value for subscriber_email_addresses then subscriber_email_addresses will be updated to empty. + * `:updateMask` (*type:* `String.t`) - A list of attributes of the case that should be updated. Supported values are `priority`, `display_name`, and `subscriber_email_addresses`. If no fields are specified, all supported fields are updated. Be careful - if you do not provide a field mask, then you might accidentally clear some fields. For example, if you leave the field mask empty and do not provide a value for `subscriber_email_addresses`, then `subscriber_email_addresses` is updated to empty. * `:body` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Case.t`) - * `opts` (*type:* `keyword()`) - Call options @@ -496,7 +498,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Search cases using the specified query. + Search for cases using a query. EXAMPLES: cURL: ```shell parent="projects/some-project" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().search( parent="projects/some-project", query="state=OPEN" ) print(request.execute()) ``` ## Parameters @@ -515,7 +517,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). * `:pageSize` (*type:* `integer()`) - The maximum number of cases fetched with each request. The default page size is 10. * `:pageToken` (*type:* `String.t`) - A token identifying the page of results to return. If unspecified, the first page is retrieved. - * `:query` (*type:* `String.t`) - An expression written in filter language. A query uses the following fields with the operators equals (`=`) and `AND`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. - `billingAccount`: A billing account in the form `billingAccounts/` You must specify eitehr `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `"my search"`. To search only cases updated after a certain date, use `update_time` retricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time>"2020-01-01T00:00:00-05:00"`. `update_time` only supports the greater than operator (`>`). Examples: - `organization="organizations/123456789"` - `project="projects/my-project-id"` - `project="projects/123456789"` - `billing_account="billingAccounts/123456-A0B0C0-CUZ789"` - `organization="organizations/123456789" AND state=CLOSED` - `project="projects/my-project-id" AND creator.email="tester@example.com"` - `project="projects/my-project-id" AND (priority=P0 OR priority=P1)` + * `:parent` (*type:* `String.t`) - The name of the parent resource to search for cases under. + * `:query` (*type:* `String.t`) - An expression used to filter cases. Expressions use the following fields separated by `AND` and specified with `=`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: Can be `OPEN` or `CLOSED`. - `priority`: Can be `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. You must specify either `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `"my search"`. To search only cases updated after a certain date, use `update_time` restricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time>"2020-01-01T00:00:00-05:00"`. `update_time` only supports the greater than operator (`>`). Examples: - `organization="organizations/123456789"` - `project="projects/my-project-id"` - `project="projects/123456789"` - `organization="organizations/123456789" AND state=CLOSED` - `project="projects/my-project-id" AND creator.email="tester@example.com"` - `project="projects/my-project-id" AND (priority=P0 OR priority=P1)` * `opts` (*type:* `keyword()`) - Call options ## Returns @@ -543,6 +546,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do :upload_protocol => :query, :pageSize => :query, :pageToken => :query, + :parent => :query, :query => :query } @@ -561,12 +565,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Retrieve all attachments associated with a support case. + List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/23598314" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$case/attachments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of Case object for which attachments should be listed. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case for which attachments should be listed. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -645,12 +649,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Add a new comment to the specified Case. The comment object must have the following fields set: body. + Add a new comment to a case. The comment must have the following fields set: `body`. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43591344" curl \\ --request POST \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --header 'Content-Type: application/json' \\ --data '{ "body": "This is a test comment." }' \\ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .create( parent="projects/some-project/cases/43595344", body={"body": "This is a test comment."}, ) ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of Case to which this comment should be added. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case to which the comment should be added. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -725,12 +729,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do end @doc """ - Retrieve all Comments associated with the Case object. + List all the comments associated with a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of Case object for which comments should be listed. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case for which to list comments. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -745,8 +749,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Cases do * `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. * `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart"). * `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart"). - * `:pageSize` (*type:* `integer()`) - The maximum number of comments fetched with each request. Defaults to 10. - * `:pageToken` (*type:* `String.t`) - A token identifying the page of results to return. If unspecified, the first page is retrieved. + * `:pageSize` (*type:* `integer()`) - The maximum number of comments to fetch. Defaults to 10. + * `:pageToken` (*type:* `String.t`) - A token identifying the page of results to return. If unspecified, the first page is returned. * `opts` (*type:* `keyword()`) - Call options ## Returns diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/media.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/media.ex index 8bb9e0ace3..1bac08b67d 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/media.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/api/media.ex @@ -26,12 +26,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Media do @library_version Mix.Project.config() |> Keyword.get(:version, "") @doc """ - Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. + Download a file attached to a case. Note: HTTP requests must append "?alt=media" to the URL. EXAMPLES: cURL: ```shell name="projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ "https://cloudsupport.googleapis.com/v2/$name:download?alt=media" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.media().download( name="projects/some-project/cases/43595344/attachments/0684M00000Pw6pHQAR" ) request.uri = request.uri.split("?")[0] + "?alt=media" print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `name`. The resource name of the attachment to be downloaded. + * `v2beta_id` (*type:* `String.t`) - Part of `name`. The name of the file attachment to download. * `v2beta_id1` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. * `attachments_id` (*type:* `String.t`) - Part of `name`. See documentation of `v2betaId`. @@ -116,12 +116,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Media do end @doc """ - Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. + Create a file attachment on a case or Cloud resource. The attachment must have the following fields set: `filename`. EXAMPLES: cURL: ```shell echo "This text is in a file I'm uploading using CSAPI." \\ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --data-binary @"./example_file.txt" \\ "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) file_path = "./example_file.txt" with open(file_path, "w") as file: file.write( "This text is inside a file I'm going to upload using the Cloud Support API.", ) request = supportApiService.media().upload( parent="projects/some-project/cases/43595344", media_body=file_path ) request.uri = request.uri.split("?")[0] + "?attachment.filename=uploaded_via_python.txt" print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of the case to which attachment should be attached. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case or Cloud resource to which the attachment should be attached. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `optional_params` (*type:* `keyword()`) - Optional parameters @@ -196,12 +196,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Media do end @doc """ - Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. + Create a file attachment on a case or Cloud resource. The attachment must have the following fields set: `filename`. EXAMPLES: cURL: ```shell echo "This text is in a file I'm uploading using CSAPI." \\ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --data-binary @"./example_file.txt" \\ "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) file_path = "./example_file.txt" with open(file_path, "w") as file: file.write( "This text is inside a file I'm going to upload using the Cloud Support API.", ) request = supportApiService.media().upload( parent="projects/some-project/cases/43595344", media_body=file_path ) request.uri = request.uri.split("?")[0] + "?attachment.filename=uploaded_via_python.txt" print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of the case to which attachment should be attached. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case or Cloud resource to which the attachment should be attached. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `upload_type` (*type:* `String.t`) - Upload type. Must be "multipart". @@ -286,12 +286,12 @@ defmodule GoogleApi.CloudSupport.V2beta.Api.Media do end @doc """ - Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. + Create a file attachment on a case or Cloud resource. The attachment must have the following fields set: `filename`. EXAMPLES: cURL: ```shell echo "This text is in a file I'm uploading using CSAPI." \\ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \\ --header "Authorization: Bearer $(gcloud auth print-access-token)" \\ --data-binary @"./example_file.txt" \\ "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) file_path = "./example_file.txt" with open(file_path, "w") as file: file.write( "This text is inside a file I'm going to upload using the Cloud Support API.", ) request = supportApiService.media().upload( parent="projects/some-project/cases/43595344", media_body=file_path ) request.uri = request.uri.split("?")[0] + "?attachment.filename=uploaded_via_python.txt" print(request.execute()) ``` ## Parameters * `connection` (*type:* `GoogleApi.CloudSupport.V2beta.Connection.t`) - Connection to server - * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The resource name of the case to which attachment should be attached. + * `v2beta_id` (*type:* `String.t`) - Part of `parent`. Required. The name of the case or Cloud resource to which the attachment should be attached. * `v2beta_id1` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `cases_id` (*type:* `String.t`) - Part of `parent`. See documentation of `v2betaId`. * `upload_type` (*type:* `String.t`) - Upload type. Must be "multipart". diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/metadata.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/metadata.ex index a8c8ec92ea..be6719b7f9 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/metadata.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/metadata.ex @@ -20,7 +20,7 @@ defmodule GoogleApi.CloudSupport.V2beta do API client metadata for GoogleApi.CloudSupport.V2beta. """ - @discovery_revision "20221114" + @discovery_revision "20240310" def discovery_revision(), do: @discovery_revision end diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/actor.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/actor.ex index 032f5adfc5..c4c795f569 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/actor.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/actor.ex @@ -17,13 +17,14 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Actor do @moduledoc """ - An object containing information about the effective user and authenticated principal responsible for an action. + An Actor represents an entity that performed an action. For example, an actor could be a user who posted a comment on a support case, a user who uploaded an attachment, or a service account that created a support case. ## Attributes * `displayName` (*type:* `String.t`, *default:* `nil`) - The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent. - * `email` (*type:* `String.t`, *default:* `nil`) - The email address of the actor. If not provided, it is inferred from credentials supplied during case creation. If the authenticated principal does not have an email address, one must be provided. When a name is provided, an email must also be provided. This will be obfuscated if the user is a Google Support agent. + * `email` (*type:* `String.t`, *default:* `nil`) - The email address of the actor. If not provided, it is inferred from the credentials supplied during case creation. When a name is provided, an email must also be provided. If the user is a Google Support agent, this is obfuscated. This field is deprecated. Use **username** field instead. * `googleSupport` (*type:* `boolean()`, *default:* `nil`) - Output only. Whether the actor is a Google support actor. + * `username` (*type:* `String.t`, *default:* `nil`) - Output only. The username of the actor. It may look like an email or other format provided by the identity provider. If not provided, it is inferred from the credentials supplied. When a name is provided, a username must also be provided. If the user is a Google Support agent, this will not be set. """ use GoogleApi.Gax.ModelBase @@ -31,12 +32,14 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Actor do @type t :: %__MODULE__{ :displayName => String.t() | nil, :email => String.t() | nil, - :googleSupport => boolean() | nil + :googleSupport => boolean() | nil, + :username => String.t() | nil } field(:displayName) field(:email) field(:googleSupport) + field(:username) end defimpl Poison.Decoder, for: GoogleApi.CloudSupport.V2beta.Model.Actor do diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/attachment.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/attachment.ex index a13bf35021..35168a1655 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/attachment.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/attachment.ex @@ -17,7 +17,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Attachment do @moduledoc """ - Represents a file attached to a support case. + An Attachment contains metadata about a file that was uploaded to a case - it is NOT a file itself. That being said, the name of an Attachment object can be used to download its accompanying file through the `media.download` endpoint. While attachments can be uploaded in the console at the same time as a comment, they're associated on a "case" level, not a "comment" level. ## Attributes diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case.ex index 4503ede6f3..4afff745b4 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case.ex @@ -17,19 +17,21 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Case do @moduledoc """ - A support case. + A Case is an object that contains the details of a support case. It contains fields for the time it was created, its priority, its classification, and more. Cases can also have comments and attachments that get added over time. A case is parented by a Google Cloud organization or project. Organizations are identified by a number, so the name of a case parented by an organization would look like this: ``` organizations/123/cases/456 ``` Projects have two unique identifiers, an ID and a number, and they look like this: ``` projects/abc/cases/456 ``` ``` projects/123/cases/456 ``` You can use either of them when calling the API. To learn more about project identifiers, see [AIP-2510](https://google.aip.dev/cloud/2510). ## Attributes * `classification` (*type:* `GoogleApi.CloudSupport.V2beta.Model.CaseClassification.t`, *default:* `nil`) - The issue classification applicable to this case. + * `contactEmail` (*type:* `String.t`, *default:* `nil`) - A user-supplied email address to send case update notifications for. This should only be used in BYOID flows, where we cannot infer the user's email address directly from their EUCs. * `createTime` (*type:* `DateTime.t`, *default:* `nil`) - Output only. The time this case was created. * `creator` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Actor.t`, *default:* `nil`) - The user who created the case. Note: The name and email will be obfuscated if the case was created by Google Support. * `description` (*type:* `String.t`, *default:* `nil`) - A broad description of the issue. * `displayName` (*type:* `String.t`, *default:* `nil`) - The short summary of the issue reported in this case. * `escalated` (*type:* `boolean()`, *default:* `nil`) - Whether the case is currently escalated. + * `languageCode` (*type:* `String.t`, *default:* `nil`) - The language the user has requested to receive support in. This should be a BCP 47 language code (e.g., `"en"`, `"zh-CN"`, `"zh-TW"`, `"ja"`, `"ko"`). If no language or an unsupported language is specified, this field defaults to English (en). Language selection during case creation may affect your available support options. For a list of supported languages and their support working hours, see: https://cloud.google.com/support/docs/language-working-hours * `name` (*type:* `String.t`, *default:* `nil`) - The resource name for the case. - * `priority` (*type:* `String.t`, *default:* `nil`) - The priority of this case. If this is set, do not set severity. - * `severity` (*type:* `String.t`, *default:* `nil`) - The severity of this case. Deprecated. Use priority instead. + * `priority` (*type:* `String.t`, *default:* `nil`) - The priority of this case. + * `severity` (*type:* `String.t`, *default:* `nil`) - REMOVED. The severity of this case. Use priority instead. * `state` (*type:* `String.t`, *default:* `nil`) - Output only. The current status of the support case. * `subscriberEmailAddresses` (*type:* `list(String.t)`, *default:* `nil`) - The email addresses to receive updates on this case. * `testCase` (*type:* `boolean()`, *default:* `nil`) - Whether this case was created for internal API testing and should not be acted on by the support team. @@ -41,11 +43,13 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Case do @type t :: %__MODULE__{ :classification => GoogleApi.CloudSupport.V2beta.Model.CaseClassification.t() | nil, + :contactEmail => String.t() | nil, :createTime => DateTime.t() | nil, :creator => GoogleApi.CloudSupport.V2beta.Model.Actor.t() | nil, :description => String.t() | nil, :displayName => String.t() | nil, :escalated => boolean() | nil, + :languageCode => String.t() | nil, :name => String.t() | nil, :priority => String.t() | nil, :severity => String.t() | nil, @@ -57,11 +61,13 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Case do } field(:classification, as: GoogleApi.CloudSupport.V2beta.Model.CaseClassification) + field(:contactEmail) field(:createTime, as: DateTime) field(:creator, as: GoogleApi.CloudSupport.V2beta.Model.Actor) field(:description) field(:displayName) field(:escalated) + field(:languageCode) field(:name) field(:priority) field(:severity) diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case_classification.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case_classification.ex index 619193bb30..dc87e1a1af 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case_classification.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/case_classification.ex @@ -17,23 +17,26 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.CaseClassification do @moduledoc """ - A classification object with a product type and value. + A Case Classification represents the topic that a case is about. It's very important to use accurate classifications, because they're used to route your cases to specialists who can help you. A classification always has an ID that is its unique identifier. A valid ID is required when creating a case. ## Attributes - * `displayName` (*type:* `String.t`, *default:* `nil`) - The display name of the classification. - * `id` (*type:* `String.t`, *default:* `nil`) - The unique ID for a classification. Must be specified for case creation. To retrieve valid classification IDs for case creation, use `caseClassifications.search`. + * `displayName` (*type:* `String.t`, *default:* `nil`) - A display name for the classification. The display name is not static and can change. To uniquely and consistently identify classifications, use the `CaseClassification.id` field. + * `id` (*type:* `String.t`, *default:* `nil`) - The unique ID for a classification. Must be specified for case creation. To retrieve valid classification IDs for case creation, use `caseClassifications.search`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least 6 months. If a given classification is deactiveated, it will immediately stop being returned. After 6 months, `case.create` requests using the classification ID will fail. + * `product` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Product.t`, *default:* `nil`) - The full product the classification corresponds to. """ use GoogleApi.Gax.ModelBase @type t :: %__MODULE__{ :displayName => String.t() | nil, - :id => String.t() | nil + :id => String.t() | nil, + :product => GoogleApi.CloudSupport.V2beta.Model.Product.t() | nil } field(:displayName) field(:id) + field(:product, as: GoogleApi.CloudSupport.V2beta.Model.Product) end defimpl Poison.Decoder, for: GoogleApi.CloudSupport.V2beta.Model.CaseClassification do diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/comment.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/comment.ex index d53931c4a3..f8f790a039 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/comment.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/comment.ex @@ -17,15 +17,15 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.Comment do @moduledoc """ - A comment associated with a support case. + Case comments are the main way Google Support communicates with a user who has opened a case. When a user responds to Google Support, the user's responses also appear as comments. ## Attributes - * `body` (*type:* `String.t`, *default:* `nil`) - The full comment body. Maximum of 120000 characters. This can contain rich text syntax. + * `body` (*type:* `String.t`, *default:* `nil`) - The full comment body. Maximum of 12800 characters. This can contain rich text syntax. * `createTime` (*type:* `DateTime.t`, *default:* `nil`) - Output only. The time when this comment was created. * `creator` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Actor.t`, *default:* `nil`) - Output only. The user or Google Support agent created this comment. * `name` (*type:* `String.t`, *default:* `nil`) - Output only. The resource name for the comment. - * `plainTextBody` (*type:* `String.t`, *default:* `nil`) - Output only. An automatically generated plain text version of body with all rich text syntax stripped. + * `plainTextBody` (*type:* `String.t`, *default:* `nil`) - Output only. DEPRECATED. An automatically generated plain text version of body with all rich text syntax stripped. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/escalate_case_request.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/escalate_case_request.ex index ecfdca77b4..350bac1ec1 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/escalate_case_request.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/escalate_case_request.ex @@ -21,7 +21,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.EscalateCaseRequest do ## Attributes - * `escalation` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Escalation.t`, *default:* `nil`) - The escalation object to be sent with the escalation request. + * `escalation` (*type:* `GoogleApi.CloudSupport.V2beta.Model.Escalation.t`, *default:* `nil`) - The escalation information to be sent with the escalation request. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_attachments_response.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_attachments_response.ex index 0c5da1cd58..fd25371d4c 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_attachments_response.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_attachments_response.ex @@ -21,8 +21,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.ListAttachmentsResponse do ## Attributes - * `attachments` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Attachment.t)`, *default:* `nil`) - The list of attachments associated with the given case. - * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `cases.attachments.list` requests. If unspecified, there are no more results to retrieve. + * `attachments` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Attachment.t)`, *default:* `nil`) - The list of attachments associated with a case. + * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.attachments.list` requests. If unspecified, there are no more results to retrieve. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_cases_response.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_cases_response.ex index 46375bda69..14e503a5b9 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_cases_response.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_cases_response.ex @@ -21,8 +21,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.ListCasesResponse do ## Attributes - * `cases` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Case.t)`, *default:* `nil`) - The list of cases associated with the cloud resource, after any filters have been applied. - * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `ListCasesRequest` message that is issued. If unspecified, there are no more results to retrieve. + * `cases` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Case.t)`, *default:* `nil`) - The list of cases associated with the parent after any filters have been applied. + * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.list` requests. If unspecified, there are no more results to retrieve. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_comments_response.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_comments_response.ex index ad048d9458..15c4245676 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_comments_response.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/list_comments_response.ex @@ -21,8 +21,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.ListCommentsResponse do ## Attributes - * `comments` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Comment.t)`, *default:* `nil`) - The list of Comments associated with the given Case. - * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `ListCommentsRequest` message that is issued. If unspecified, there are no more results to retrieve. + * `comments` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Comment.t)`, *default:* `nil`) - List of the comments associated with the case. + * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.comments.list` requests. If unspecified, there are no more results to retrieve. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/product.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/product.ex new file mode 100644 index 0000000000..3fff597b5c --- /dev/null +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/product.ex @@ -0,0 +1,49 @@ +# Copyright 2019 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# NOTE: This file is auto generated by the elixir code generator program. +# Do not edit this file manually. + +defmodule GoogleApi.CloudSupport.V2beta.Model.Product do + @moduledoc """ + The full product a case may be associated with, including Product Line and Product Subline. + + ## Attributes + + * `productLine` (*type:* `String.t`, *default:* `nil`) - The Product Line of the Product. + * `productSubline` (*type:* `String.t`, *default:* `nil`) - The Product Subline of the Product, such as "Maps Billing". + """ + + use GoogleApi.Gax.ModelBase + + @type t :: %__MODULE__{ + :productLine => String.t() | nil, + :productSubline => String.t() | nil + } + + field(:productLine) + field(:productSubline) +end + +defimpl Poison.Decoder, for: GoogleApi.CloudSupport.V2beta.Model.Product do + def decode(value, options) do + GoogleApi.CloudSupport.V2beta.Model.Product.decode(value, options) + end +end + +defimpl Poison.Encoder, for: GoogleApi.CloudSupport.V2beta.Model.Product do + def encode(value, options) do + GoogleApi.Gax.ModelBase.encode(value, options) + end +end diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_case_classifications_response.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_case_classifications_response.ex index d37c64bb71..6fde17c47a 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_case_classifications_response.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_case_classifications_response.ex @@ -22,7 +22,7 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.SearchCaseClassificationsResponse ## Attributes * `caseClassifications` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.CaseClassification.t)`, *default:* `nil`) - The classifications retrieved. - * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `SearchCaseClassificationsRequest` message that is issued. If unspecified, there are no more results to retrieve. + * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `caseClassifications.list` requests. If unspecified, there are no more results to retrieve. """ use GoogleApi.Gax.ModelBase diff --git a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_cases_response.ex b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_cases_response.ex index 63f6daf77b..2ea2e9ac66 100644 --- a/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_cases_response.ex +++ b/clients/cloud_support/lib/google_api/cloud_support/v2beta/model/search_cases_response.ex @@ -21,8 +21,8 @@ defmodule GoogleApi.CloudSupport.V2beta.Model.SearchCasesResponse do ## Attributes - * `cases` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Case.t)`, *default:* `nil`) - The list of Case associated with the cloud resource, after any filters have been applied. - * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `SearchCaseRequest` message that is issued. If unspecified, there are no more results to retrieve. + * `cases` (*type:* `list(GoogleApi.CloudSupport.V2beta.Model.Case.t)`, *default:* `nil`) - The list of cases associated with the parent after any filters have been applied. + * `nextPageToken` (*type:* `String.t`, *default:* `nil`) - A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.search` requests. If unspecified, there are no more results to retrieve. """ use GoogleApi.Gax.ModelBase