diff --git a/docs/auth-guide.md b/docs/auth-guide.md index d855b991b..4ddff191c 100644 --- a/docs/auth-guide.md +++ b/docs/auth-guide.md @@ -1,8 +1,8 @@ -# Authentication for Legacy REST Clients +# Authentication for Simple REST Clients This document describes how authentication, authorization, and accounting are accomplished. For all API calls, your application needs to be authenticated. When an API accesses a user's private data, your application must also be authorized by the user to access the data. For example, accessing a public Google+ post would not require user authorization, but accessing a user's private calendar would. Also, for quota and billing purposes, all API calls involve accounting. This document summarizes the protocols used by Google APIs and provides links to more information. -> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All legacy REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. +> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All simple REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. ## Access types diff --git a/docs/oauth-installed.md b/docs/oauth-installed.md index ba87e3f74..d4b500f28 100644 --- a/docs/oauth-installed.md +++ b/docs/oauth-installed.md @@ -11,7 +11,7 @@ If you are writing an app for Android or iOS, use [Google Sign-In](https://devel If your app will run on devices that do not have access to a system browser, or devices with limited input capabilities (for example, if your app will run on game consoles, video cameras, or printers), then see [Using OAuth 2.0 for Devices](https://developers.google.com/accounts/docs/OAuth2ForDevices). -> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All legacy REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. +> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All simple REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. ## Overview diff --git a/docs/oauth-server.md b/docs/oauth-server.md index 7b5289c37..6adb63bee 100644 --- a/docs/oauth-server.md +++ b/docs/oauth-server.md @@ -12,7 +12,7 @@ If you have a G Suite domain—if you use [G Suite](https://gsuite.google.com/), This document describes how an application can complete the server-to-server OAuth 2.0 flow by using the Google APIs Client Library for Ruby. -> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All legacy REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. +> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All simple REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. ## Overview diff --git a/docs/oauth-web.md b/docs/oauth-web.md index da2c93702..06811acd6 100644 --- a/docs/oauth-web.md +++ b/docs/oauth-web.md @@ -6,7 +6,7 @@ This OAuth 2.0 flow is specifically for user authorization. It is designed for a Web server applications frequently also use service accounts to authorize API requests, particularly when calling Cloud APIs to access project-based data rather than user-specific data. Web server applications can use service accounts in conjunction with user authorization. -> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All legacy REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. +> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All simple REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. ## Prerequisites diff --git a/docs/usage-guide.md b/docs/usage-guide.md index 063195c20..7f2102adc 100644 --- a/docs/usage-guide.md +++ b/docs/usage-guide.md @@ -1,8 +1,8 @@ -# Usage Guide for Legacy REST Clients +# Usage Guide for Simple REST Clients -This document provides all the basic information you need to start using the legacy REST clients for Google APIs. It covers important library concepts, shows examples for various use cases, and gives links to more information. +This document provides all the basic information you need to start using the simple REST clients for Google APIs. It covers important library concepts, shows examples for various use cases, and gives links to more information. -> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All legacy REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. +> **Note:** this is a "general" document, and not specific to this particular service client. In particular, you may find that the examples in this document are for a different client. All simple REST clients follow the same usage patterns, and you should be able to adapt the provided examples to the client you are using. ## Before you begin @@ -58,11 +58,11 @@ drive.get_file(metadata.id, download_dest: '/tmp/myfile.txt') ## Authorization -All API calls need to be authenticated, to ensure authorized access to data, and for proper accounting for quota and billing. Google legacy REST clients support several different types of authentication, including OAuth 2.0, service accounts, API keys, and default credentials. Detailed documentation, including examples of several common authentication flows, is provided in the separate [Auth Guide](auth-guide.md). In the present document, we will discuss a few basic cases to get started. +All API calls need to be authenticated, to ensure authorized access to data, and for proper accounting for quota and billing. Google simple REST clients support several different types of authentication, including OAuth 2.0, service accounts, API keys, and default credentials. Detailed documentation, including examples of several common authentication flows, is provided in the separate [Auth Guide](auth-guide.md). In the present document, we will discuss a few basic cases to get started. ### Auth libraries -Most auth functionality is provided in two separate Ruby gems, which legacy REST clients bring in as dependencies. +Most auth functionality is provided in two separate Ruby gems, which simple REST clients bring in as dependencies. * The [signet](https://github.com/google/signet) gem is a basic implementation of [OAuth 2](https://developers.google.com/accounts/docs/OAuth2). For calls that require per-user authorization, it can be used to direct the OAuth flow needed to obtain authorization. * The [googleauth](https://github.com/google/google-auth-library-ruby) gem builds atop signet, and offers a simple way to get credentials for use in Google APIs when auth is independent of the user. In particular, this is the recommend approach for many Cloud APIs. diff --git a/generated/google-apis-abusiveexperiencereport_v1/CHANGELOG.md b/generated/google-apis-abusiveexperiencereport_v1/CHANGELOG.md index c3e1b7620..b45e264af 100644 --- a/generated/google-apis-abusiveexperiencereport_v1/CHANGELOG.md +++ b/generated/google-apis-abusiveexperiencereport_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-abusiveexperiencereport_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-abusiveexperiencereport_v1/OVERVIEW.md b/generated/google-apis-abusiveexperiencereport_v1/OVERVIEW.md index 5cd79d131..2ede3612a 100644 --- a/generated/google-apis-abusiveexperiencereport_v1/OVERVIEW.md +++ b/generated/google-apis-abusiveexperiencereport_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Abusive Experience Report API +# Simple REST client for version V1 of the Abusive Experience Report API This is a simple client library for version V1 of the Abusive Experience Report API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Abusive Experience Report * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Abusiveexperiencereport service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Abusiveexperiencereport service in particular.) For reference information on specific calls in the Abusive Experience Report API, see the {Google::Apis::AbusiveexperiencereportV1::AbusiveExperienceReportService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-abusiveexperiencereport_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-abusiveexperiencereport_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/abusive-experience-report/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-abusiveexperiencereport_v1/google-apis-abusiveexperiencereport_v1.gemspec b/generated/google-apis-abusiveexperiencereport_v1/google-apis-abusiveexperiencereport_v1.gemspec index 798fd95d1..1a286b96c 100644 --- a/generated/google-apis-abusiveexperiencereport_v1/google-apis-abusiveexperiencereport_v1.gemspec +++ b/generated/google-apis-abusiveexperiencereport_v1/google-apis-abusiveexperiencereport_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AbusiveexperiencereportV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Abusive Experience Report API V1" + gem.summary = "Simple REST client for Abusive Experience Report API V1" gem.description = - "This is the legacy REST client for Abusive Experience Report API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Abusive Experience Report API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-abusiveexperiencereport_v1/lib/google/apis/abusiveexperiencereport_v1/gem_version.rb b/generated/google-apis-abusiveexperiencereport_v1/lib/google/apis/abusiveexperiencereport_v1/gem_version.rb index 3c23c76af..208fe0054 100644 --- a/generated/google-apis-abusiveexperiencereport_v1/lib/google/apis/abusiveexperiencereport_v1/gem_version.rb +++ b/generated/google-apis-abusiveexperiencereport_v1/lib/google/apis/abusiveexperiencereport_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-acceleratedmobilepageurl_v1/CHANGELOG.md b/generated/google-apis-acceleratedmobilepageurl_v1/CHANGELOG.md index 5bfca53e0..496e2de5c 100644 --- a/generated/google-apis-acceleratedmobilepageurl_v1/CHANGELOG.md +++ b/generated/google-apis-acceleratedmobilepageurl_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-acceleratedmobilepageurl_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200916 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-acceleratedmobilepageurl_v1/OVERVIEW.md b/generated/google-apis-acceleratedmobilepageurl_v1/OVERVIEW.md index 6a71cb18e..84e0f705d 100644 --- a/generated/google-apis-acceleratedmobilepageurl_v1/OVERVIEW.md +++ b/generated/google-apis-acceleratedmobilepageurl_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Accelerated Mobile Pages (AMP) URL API +# Simple REST client for version V1 of the Accelerated Mobile Pages (AMP) URL API This is a simple client library for version V1 of the Accelerated Mobile Pages (AMP) URL API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Accelerated Mobile Pages ( * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Acceleratedmobilepageurl service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Acceleratedmobilepageurl service in particular.) For reference information on specific calls in the Accelerated Mobile Pages (AMP) URL API, see the {Google::Apis::AcceleratedmobilepageurlV1::AcceleratedmobilepageurlService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-acceleratedmobilepageurl_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-acceleratedmobilepageurl_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/amp/cache/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-acceleratedmobilepageurl_v1/google-apis-acceleratedmobilepageurl_v1.gemspec b/generated/google-apis-acceleratedmobilepageurl_v1/google-apis-acceleratedmobilepageurl_v1.gemspec index ded96adce..b18d6f436 100644 --- a/generated/google-apis-acceleratedmobilepageurl_v1/google-apis-acceleratedmobilepageurl_v1.gemspec +++ b/generated/google-apis-acceleratedmobilepageurl_v1/google-apis-acceleratedmobilepageurl_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AcceleratedmobilepageurlV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Accelerated Mobile Pages (AMP) URL API V1" + gem.summary = "Simple REST client for Accelerated Mobile Pages (AMP) URL API V1" gem.description = - "This is the legacy REST client for Accelerated Mobile Pages (AMP) URL API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Accelerated Mobile Pages (AMP) URL API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-acceleratedmobilepageurl_v1/lib/google/apis/acceleratedmobilepageurl_v1/gem_version.rb b/generated/google-apis-acceleratedmobilepageurl_v1/lib/google/apis/acceleratedmobilepageurl_v1/gem_version.rb index 7a81d6c11..9238bc118 100644 --- a/generated/google-apis-acceleratedmobilepageurl_v1/lib/google/apis/acceleratedmobilepageurl_v1/gem_version.rb +++ b/generated/google-apis-acceleratedmobilepageurl_v1/lib/google/apis/acceleratedmobilepageurl_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200916" diff --git a/generated/google-apis-accessapproval_v1/CHANGELOG.md b/generated/google-apis-accessapproval_v1/CHANGELOG.md index 9fb1a7e1d..c1aa94cd2 100644 --- a/generated/google-apis-accessapproval_v1/CHANGELOG.md +++ b/generated/google-apis-accessapproval_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-accessapproval_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201030 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-accessapproval_v1/OVERVIEW.md b/generated/google-apis-accessapproval_v1/OVERVIEW.md index 2ed9ea31a..66e889b95 100644 --- a/generated/google-apis-accessapproval_v1/OVERVIEW.md +++ b/generated/google-apis-accessapproval_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Access Approval API +# Simple REST client for version V1 of the Access Approval API This is a simple client library for version V1 of the Access Approval API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Access Approval API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Accessapproval service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Accessapproval service in particular.) For reference information on specific calls in the Access Approval API, see the {Google::Apis::AccessapprovalV1::AccessApprovalService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-accessapproval_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-accessapproval_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/access-approval/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-accessapproval_v1/google-apis-accessapproval_v1.gemspec b/generated/google-apis-accessapproval_v1/google-apis-accessapproval_v1.gemspec index afae0c6f7..4b9e4a623 100644 --- a/generated/google-apis-accessapproval_v1/google-apis-accessapproval_v1.gemspec +++ b/generated/google-apis-accessapproval_v1/google-apis-accessapproval_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AccessapprovalV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Access Approval API V1" + gem.summary = "Simple REST client for Access Approval API V1" gem.description = - "This is the legacy REST client for Access Approval API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Access Approval API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-accessapproval_v1/lib/google/apis/accessapproval_v1/gem_version.rb b/generated/google-apis-accessapproval_v1/lib/google/apis/accessapproval_v1/gem_version.rb index 2fd48c81f..5cdf4b4f4 100644 --- a/generated/google-apis-accessapproval_v1/lib/google/apis/accessapproval_v1/gem_version.rb +++ b/generated/google-apis-accessapproval_v1/lib/google/apis/accessapproval_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201030" diff --git a/generated/google-apis-accesscontextmanager_v1/CHANGELOG.md b/generated/google-apis-accesscontextmanager_v1/CHANGELOG.md index 22c056c50..ef578ab92 100644 --- a/generated/google-apis-accesscontextmanager_v1/CHANGELOG.md +++ b/generated/google-apis-accesscontextmanager_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-accesscontextmanager_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201210 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-accesscontextmanager_v1/OVERVIEW.md b/generated/google-apis-accesscontextmanager_v1/OVERVIEW.md index f911215cc..98441b364 100644 --- a/generated/google-apis-accesscontextmanager_v1/OVERVIEW.md +++ b/generated/google-apis-accesscontextmanager_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Access Context Manager API +# Simple REST client for version V1 of the Access Context Manager API This is a simple client library for version V1 of the Access Context Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Access Context Manager API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Accesscontextmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Accesscontextmanager service in particular.) For reference information on specific calls in the Access Context Manager API, see the {Google::Apis::AccesscontextmanagerV1::AccessContextManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-accesscontextmanager_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-accesscontextmanager_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/access-context-manager/docs/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-accesscontextmanager_v1/google-apis-accesscontextmanager_v1.gemspec b/generated/google-apis-accesscontextmanager_v1/google-apis-accesscontextmanager_v1.gemspec index f4fac4200..e5ee35e57 100644 --- a/generated/google-apis-accesscontextmanager_v1/google-apis-accesscontextmanager_v1.gemspec +++ b/generated/google-apis-accesscontextmanager_v1/google-apis-accesscontextmanager_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AccesscontextmanagerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Access Context Manager API V1" + gem.summary = "Simple REST client for Access Context Manager API V1" gem.description = - "This is the legacy REST client for Access Context Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Access Context Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-accesscontextmanager_v1/lib/google/apis/accesscontextmanager_v1/gem_version.rb b/generated/google-apis-accesscontextmanager_v1/lib/google/apis/accesscontextmanager_v1/gem_version.rb index 9e5580cb4..7c0d3a7cf 100644 --- a/generated/google-apis-accesscontextmanager_v1/lib/google/apis/accesscontextmanager_v1/gem_version.rb +++ b/generated/google-apis-accesscontextmanager_v1/lib/google/apis/accesscontextmanager_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201210" diff --git a/generated/google-apis-accesscontextmanager_v1beta/CHANGELOG.md b/generated/google-apis-accesscontextmanager_v1beta/CHANGELOG.md index f52877260..2b8aa5eb3 100644 --- a/generated/google-apis-accesscontextmanager_v1beta/CHANGELOG.md +++ b/generated/google-apis-accesscontextmanager_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-accesscontextmanager_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200825 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-accesscontextmanager_v1beta/OVERVIEW.md b/generated/google-apis-accesscontextmanager_v1beta/OVERVIEW.md index 13e5c1c71..61b400e7a 100644 --- a/generated/google-apis-accesscontextmanager_v1beta/OVERVIEW.md +++ b/generated/google-apis-accesscontextmanager_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Access Context Manager API +# Simple REST client for version V1beta of the Access Context Manager API This is a simple client library for version V1beta of the Access Context Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Access Context Manager * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Accesscontextmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Accesscontextmanager service in particular.) For reference information on specific calls in the Access Context Manager API, see the {Google::Apis::AccesscontextmanagerV1beta::AccessContextManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-accesscontextmanager_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-accesscontextmanager_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/access-context-manager/docs/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-accesscontextmanager_v1beta/google-apis-accesscontextmanager_v1beta.gemspec b/generated/google-apis-accesscontextmanager_v1beta/google-apis-accesscontextmanager_v1beta.gemspec index 51cd0c92d..04340730b 100644 --- a/generated/google-apis-accesscontextmanager_v1beta/google-apis-accesscontextmanager_v1beta.gemspec +++ b/generated/google-apis-accesscontextmanager_v1beta/google-apis-accesscontextmanager_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AccesscontextmanagerV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Access Context Manager API V1beta" + gem.summary = "Simple REST client for Access Context Manager API V1beta" gem.description = - "This is the legacy REST client for Access Context Manager API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Access Context Manager API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-accesscontextmanager_v1beta/lib/google/apis/accesscontextmanager_v1beta/gem_version.rb b/generated/google-apis-accesscontextmanager_v1beta/lib/google/apis/accesscontextmanager_v1beta/gem_version.rb index 30f2a6967..0cee78f93 100644 --- a/generated/google-apis-accesscontextmanager_v1beta/lib/google/apis/accesscontextmanager_v1beta/gem_version.rb +++ b/generated/google-apis-accesscontextmanager_v1beta/lib/google/apis/accesscontextmanager_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200825" diff --git a/generated/google-apis-adexchangebuyer2_v2beta1/CHANGELOG.md b/generated/google-apis-adexchangebuyer2_v2beta1/CHANGELOG.md index b2ae04a6e..870e4fc1f 100644 --- a/generated/google-apis-adexchangebuyer2_v2beta1/CHANGELOG.md +++ b/generated/google-apis-adexchangebuyer2_v2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adexchangebuyer2_v2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adexchangebuyer2_v2beta1/OVERVIEW.md b/generated/google-apis-adexchangebuyer2_v2beta1/OVERVIEW.md index 33abe1644..cfff8bc1f 100644 --- a/generated/google-apis-adexchangebuyer2_v2beta1/OVERVIEW.md +++ b/generated/google-apis-adexchangebuyer2_v2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta1 of the Ad Exchange Buyer API II +# Simple REST client for version V2beta1 of the Ad Exchange Buyer API II This is a simple client library for version V2beta1 of the Ad Exchange Buyer API II. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta1 of the Ad Exchange Buyer API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adexchangebuyer2 service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adexchangebuyer2 service in particular.) For reference information on specific calls in the Ad Exchange Buyer API II, see the {Google::Apis::Adexchangebuyer2V2beta1::AdExchangeBuyerIIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adexchangebuyer2_v2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adexchangebuyer2_v2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/authorized-buyers/apis/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adexchangebuyer2_v2beta1/google-apis-adexchangebuyer2_v2beta1.gemspec b/generated/google-apis-adexchangebuyer2_v2beta1/google-apis-adexchangebuyer2_v2beta1.gemspec index 27feeb0ed..f95fe405f 100644 --- a/generated/google-apis-adexchangebuyer2_v2beta1/google-apis-adexchangebuyer2_v2beta1.gemspec +++ b/generated/google-apis-adexchangebuyer2_v2beta1/google-apis-adexchangebuyer2_v2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::Adexchangebuyer2V2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Ad Exchange Buyer API II V2beta1" + gem.summary = "Simple REST client for Ad Exchange Buyer API II V2beta1" gem.description = - "This is the legacy REST client for Ad Exchange Buyer API II V2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Ad Exchange Buyer API II V2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adexchangebuyer2_v2beta1/lib/google/apis/adexchangebuyer2_v2beta1/gem_version.rb b/generated/google-apis-adexchangebuyer2_v2beta1/lib/google/apis/adexchangebuyer2_v2beta1/gem_version.rb index af420766b..8e794ad8b 100644 --- a/generated/google-apis-adexchangebuyer2_v2beta1/lib/google/apis/adexchangebuyer2_v2beta1/gem_version.rb +++ b/generated/google-apis-adexchangebuyer2_v2beta1/lib/google/apis/adexchangebuyer2_v2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-adexchangebuyer_v1_2/CHANGELOG.md b/generated/google-apis-adexchangebuyer_v1_2/CHANGELOG.md index 2bcd68fe9..939754521 100644 --- a/generated/google-apis-adexchangebuyer_v1_2/CHANGELOG.md +++ b/generated/google-apis-adexchangebuyer_v1_2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adexchangebuyer_v1_2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20180222 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adexchangebuyer_v1_2/OVERVIEW.md b/generated/google-apis-adexchangebuyer_v1_2/OVERVIEW.md index 212af7cf7..0ec01fb05 100644 --- a/generated/google-apis-adexchangebuyer_v1_2/OVERVIEW.md +++ b/generated/google-apis-adexchangebuyer_v1_2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1_2 of the Ad Exchange Buyer API +# Simple REST client for version V1_2 of the Ad Exchange Buyer API This is a simple client library for version V1_2 of the Ad Exchange Buyer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1_2 of the Ad Exchange Buyer API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) For reference information on specific calls in the Ad Exchange Buyer API, see the {Google::Apis::AdexchangebuyerV1_2::AdExchangeBuyerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adexchangebuyer_v1_2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adexchangebuyer_v1_2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/ad-exchange/buyer-rest) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adexchangebuyer_v1_2/google-apis-adexchangebuyer_v1_2.gemspec b/generated/google-apis-adexchangebuyer_v1_2/google-apis-adexchangebuyer_v1_2.gemspec index ef67ddd24..493345c0f 100644 --- a/generated/google-apis-adexchangebuyer_v1_2/google-apis-adexchangebuyer_v1_2.gemspec +++ b/generated/google-apis-adexchangebuyer_v1_2/google-apis-adexchangebuyer_v1_2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdexchangebuyerV1_2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Ad Exchange Buyer API V1_2" + gem.summary = "Simple REST client for Ad Exchange Buyer API V1_2" gem.description = - "This is the legacy REST client for Ad Exchange Buyer API V1_2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Ad Exchange Buyer API V1_2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adexchangebuyer_v1_2/lib/google/apis/adexchangebuyer_v1_2/gem_version.rb b/generated/google-apis-adexchangebuyer_v1_2/lib/google/apis/adexchangebuyer_v1_2/gem_version.rb index cb669d642..8a98c6655 100644 --- a/generated/google-apis-adexchangebuyer_v1_2/lib/google/apis/adexchangebuyer_v1_2/gem_version.rb +++ b/generated/google-apis-adexchangebuyer_v1_2/lib/google/apis/adexchangebuyer_v1_2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20180222" diff --git a/generated/google-apis-adexchangebuyer_v1_3/CHANGELOG.md b/generated/google-apis-adexchangebuyer_v1_3/CHANGELOG.md index 8c766814c..78f3fa95c 100644 --- a/generated/google-apis-adexchangebuyer_v1_3/CHANGELOG.md +++ b/generated/google-apis-adexchangebuyer_v1_3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adexchangebuyer_v1_3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20191108 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adexchangebuyer_v1_3/OVERVIEW.md b/generated/google-apis-adexchangebuyer_v1_3/OVERVIEW.md index c48e96fa2..4c94056d8 100644 --- a/generated/google-apis-adexchangebuyer_v1_3/OVERVIEW.md +++ b/generated/google-apis-adexchangebuyer_v1_3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1_3 of the Ad Exchange Buyer API +# Simple REST client for version V1_3 of the Ad Exchange Buyer API This is a simple client library for version V1_3 of the Ad Exchange Buyer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1_3 of the Ad Exchange Buyer API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) For reference information on specific calls in the Ad Exchange Buyer API, see the {Google::Apis::AdexchangebuyerV1_3::AdExchangeBuyerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adexchangebuyer_v1_3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adexchangebuyer_v1_3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/ad-exchange/buyer-rest) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adexchangebuyer_v1_3/google-apis-adexchangebuyer_v1_3.gemspec b/generated/google-apis-adexchangebuyer_v1_3/google-apis-adexchangebuyer_v1_3.gemspec index a76966b9d..e68e099d7 100644 --- a/generated/google-apis-adexchangebuyer_v1_3/google-apis-adexchangebuyer_v1_3.gemspec +++ b/generated/google-apis-adexchangebuyer_v1_3/google-apis-adexchangebuyer_v1_3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdexchangebuyerV1_3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Ad Exchange Buyer API V1_3" + gem.summary = "Simple REST client for Ad Exchange Buyer API V1_3" gem.description = - "This is the legacy REST client for Ad Exchange Buyer API V1_3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Ad Exchange Buyer API V1_3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adexchangebuyer_v1_3/lib/google/apis/adexchangebuyer_v1_3/gem_version.rb b/generated/google-apis-adexchangebuyer_v1_3/lib/google/apis/adexchangebuyer_v1_3/gem_version.rb index 73fc9d646..4bad47131 100644 --- a/generated/google-apis-adexchangebuyer_v1_3/lib/google/apis/adexchangebuyer_v1_3/gem_version.rb +++ b/generated/google-apis-adexchangebuyer_v1_3/lib/google/apis/adexchangebuyer_v1_3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20191108" diff --git a/generated/google-apis-adexchangebuyer_v1_4/CHANGELOG.md b/generated/google-apis-adexchangebuyer_v1_4/CHANGELOG.md index eea4cb0b2..27d350496 100644 --- a/generated/google-apis-adexchangebuyer_v1_4/CHANGELOG.md +++ b/generated/google-apis-adexchangebuyer_v1_4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adexchangebuyer_v1_4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201004 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adexchangebuyer_v1_4/OVERVIEW.md b/generated/google-apis-adexchangebuyer_v1_4/OVERVIEW.md index bfd29c6a7..d93a569b6 100644 --- a/generated/google-apis-adexchangebuyer_v1_4/OVERVIEW.md +++ b/generated/google-apis-adexchangebuyer_v1_4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1_4 of the Ad Exchange Buyer API +# Simple REST client for version V1_4 of the Ad Exchange Buyer API This is a simple client library for version V1_4 of the Ad Exchange Buyer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1_4 of the Ad Exchange Buyer API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adexchangebuyer service in particular.) For reference information on specific calls in the Ad Exchange Buyer API, see the {Google::Apis::AdexchangebuyerV1_4::AdExchangeBuyerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adexchangebuyer_v1_4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adexchangebuyer_v1_4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/ad-exchange/buyer-rest) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adexchangebuyer_v1_4/google-apis-adexchangebuyer_v1_4.gemspec b/generated/google-apis-adexchangebuyer_v1_4/google-apis-adexchangebuyer_v1_4.gemspec index f1d16836d..57d17d913 100644 --- a/generated/google-apis-adexchangebuyer_v1_4/google-apis-adexchangebuyer_v1_4.gemspec +++ b/generated/google-apis-adexchangebuyer_v1_4/google-apis-adexchangebuyer_v1_4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdexchangebuyerV1_4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Ad Exchange Buyer API V1_4" + gem.summary = "Simple REST client for Ad Exchange Buyer API V1_4" gem.description = - "This is the legacy REST client for Ad Exchange Buyer API V1_4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Ad Exchange Buyer API V1_4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adexchangebuyer_v1_4/lib/google/apis/adexchangebuyer_v1_4/gem_version.rb b/generated/google-apis-adexchangebuyer_v1_4/lib/google/apis/adexchangebuyer_v1_4/gem_version.rb index db7427eb9..107ed4fb1 100644 --- a/generated/google-apis-adexchangebuyer_v1_4/lib/google/apis/adexchangebuyer_v1_4/gem_version.rb +++ b/generated/google-apis-adexchangebuyer_v1_4/lib/google/apis/adexchangebuyer_v1_4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201004" diff --git a/generated/google-apis-adexperiencereport_v1/CHANGELOG.md b/generated/google-apis-adexperiencereport_v1/CHANGELOG.md index b3c65e040..e81febb77 100644 --- a/generated/google-apis-adexperiencereport_v1/CHANGELOG.md +++ b/generated/google-apis-adexperiencereport_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adexperiencereport_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200823 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adexperiencereport_v1/OVERVIEW.md b/generated/google-apis-adexperiencereport_v1/OVERVIEW.md index 78ca0fcd9..8a97e3631 100644 --- a/generated/google-apis-adexperiencereport_v1/OVERVIEW.md +++ b/generated/google-apis-adexperiencereport_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Ad Experience Report API +# Simple REST client for version V1 of the Ad Experience Report API This is a simple client library for version V1 of the Ad Experience Report API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Ad Experience Report API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adexperiencereport service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adexperiencereport service in particular.) For reference information on specific calls in the Ad Experience Report API, see the {Google::Apis::AdexperiencereportV1::AdExperienceReportService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adexperiencereport_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adexperiencereport_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/ad-experience-report/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adexperiencereport_v1/google-apis-adexperiencereport_v1.gemspec b/generated/google-apis-adexperiencereport_v1/google-apis-adexperiencereport_v1.gemspec index 0fb8e3c24..7695d1315 100644 --- a/generated/google-apis-adexperiencereport_v1/google-apis-adexperiencereport_v1.gemspec +++ b/generated/google-apis-adexperiencereport_v1/google-apis-adexperiencereport_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdexperiencereportV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Ad Experience Report API V1" + gem.summary = "Simple REST client for Ad Experience Report API V1" gem.description = - "This is the legacy REST client for Ad Experience Report API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Ad Experience Report API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adexperiencereport_v1/lib/google/apis/adexperiencereport_v1/gem_version.rb b/generated/google-apis-adexperiencereport_v1/lib/google/apis/adexperiencereport_v1/gem_version.rb index ed9b04604..ca511eff4 100644 --- a/generated/google-apis-adexperiencereport_v1/lib/google/apis/adexperiencereport_v1/gem_version.rb +++ b/generated/google-apis-adexperiencereport_v1/lib/google/apis/adexperiencereport_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200823" diff --git a/generated/google-apis-admin_datatransfer_v1/OVERVIEW.md b/generated/google-apis-admin_datatransfer_v1/OVERVIEW.md index a7c19838f..7e82241b3 100644 --- a/generated/google-apis-admin_datatransfer_v1/OVERVIEW.md +++ b/generated/google-apis-admin_datatransfer_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version DatatransferV1 of the Admin SDK API +# Simple REST client for version DatatransferV1 of the Admin SDK API This is a simple client library for version DatatransferV1 of the Admin SDK API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version DatatransferV1 of the Admin SDK API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Admin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Admin service in particular.) For reference information on specific calls in the Admin SDK API, see the {Google::Apis::AdminDatatransferV1::DataTransferService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-admin_datatransfer_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-admin_datatransfer_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://developers.google.com/admin-sdk/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-admin_datatransfer_v1/google-apis-admin_datatransfer_v1.gemspec b/generated/google-apis-admin_datatransfer_v1/google-apis-admin_datatransfer_v1.gemspec index 8540b7e17..e40456b35 100644 --- a/generated/google-apis-admin_datatransfer_v1/google-apis-admin_datatransfer_v1.gemspec +++ b/generated/google-apis-admin_datatransfer_v1/google-apis-admin_datatransfer_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdminDatatransferV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Admin SDK API DatatransferV1" + gem.summary = "Simple REST client for Admin SDK API DatatransferV1" gem.description = - "This is the legacy REST client for Admin SDK API DatatransferV1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Admin SDK API DatatransferV1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-admin_directory_v1/OVERVIEW.md b/generated/google-apis-admin_directory_v1/OVERVIEW.md index cf9c50ec2..312da7df0 100644 --- a/generated/google-apis-admin_directory_v1/OVERVIEW.md +++ b/generated/google-apis-admin_directory_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version DirectoryV1 of the Admin SDK API +# Simple REST client for version DirectoryV1 of the Admin SDK API This is a simple client library for version DirectoryV1 of the Admin SDK API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version DirectoryV1 of the Admin SDK API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Admin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Admin service in particular.) For reference information on specific calls in the Admin SDK API, see the {Google::Apis::AdminDirectoryV1::DirectoryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-admin_directory_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-admin_directory_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://developers.google.com/admin-sdk/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-admin_directory_v1/google-apis-admin_directory_v1.gemspec b/generated/google-apis-admin_directory_v1/google-apis-admin_directory_v1.gemspec index da1ba0753..f3bf71d21 100644 --- a/generated/google-apis-admin_directory_v1/google-apis-admin_directory_v1.gemspec +++ b/generated/google-apis-admin_directory_v1/google-apis-admin_directory_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdminDirectoryV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Admin SDK API DirectoryV1" + gem.summary = "Simple REST client for Admin SDK API DirectoryV1" gem.description = - "This is the legacy REST client for Admin SDK API DirectoryV1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Admin SDK API DirectoryV1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-admin_reports_v1/CHANGELOG.md b/generated/google-apis-admin_reports_v1/CHANGELOG.md index 27c437ea5..d4adcd9d9 100644 --- a/generated/google-apis-admin_reports_v1/CHANGELOG.md +++ b/generated/google-apis-admin_reports_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-admin_reports_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-admin_reports_v1/OVERVIEW.md b/generated/google-apis-admin_reports_v1/OVERVIEW.md index 26ef52f06..cd0f8057c 100644 --- a/generated/google-apis-admin_reports_v1/OVERVIEW.md +++ b/generated/google-apis-admin_reports_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version ReportsV1 of the Admin SDK API +# Simple REST client for version ReportsV1 of the Admin SDK API This is a simple client library for version ReportsV1 of the Admin SDK API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version ReportsV1 of the Admin SDK API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Admin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Admin service in particular.) For reference information on specific calls in the Admin SDK API, see the {Google::Apis::AdminReportsV1::ReportsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-admin_reports_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-admin_reports_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://developers.google.com/admin-sdk/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-admin_reports_v1/google-apis-admin_reports_v1.gemspec b/generated/google-apis-admin_reports_v1/google-apis-admin_reports_v1.gemspec index b73768b2f..f2f875bcc 100644 --- a/generated/google-apis-admin_reports_v1/google-apis-admin_reports_v1.gemspec +++ b/generated/google-apis-admin_reports_v1/google-apis-admin_reports_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdminReportsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Admin SDK API ReportsV1" + gem.summary = "Simple REST client for Admin SDK API ReportsV1" gem.description = - "This is the legacy REST client for Admin SDK API ReportsV1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Admin SDK API ReportsV1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-admin_reports_v1/lib/google/apis/admin_reports_v1/gem_version.rb b/generated/google-apis-admin_reports_v1/lib/google/apis/admin_reports_v1/gem_version.rb index cc5316c25..3688f52eb 100644 --- a/generated/google-apis-admin_reports_v1/lib/google/apis/admin_reports_v1/gem_version.rb +++ b/generated/google-apis-admin_reports_v1/lib/google/apis/admin_reports_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-admob_v1/OVERVIEW.md b/generated/google-apis-admob_v1/OVERVIEW.md index bd93a67d8..bc2182933 100644 --- a/generated/google-apis-admob_v1/OVERVIEW.md +++ b/generated/google-apis-admob_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the AdMob API +# Simple REST client for version V1 of the AdMob API This is a simple client library for version V1 of the AdMob API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the AdMob API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Admob service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Admob service in particular.) For reference information on specific calls in the AdMob API, see the {Google::Apis::AdmobV1::AdMobService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-admob_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-admob_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/admob/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-admob_v1/google-apis-admob_v1.gemspec b/generated/google-apis-admob_v1/google-apis-admob_v1.gemspec index e6176dc5d..a61ec6330 100644 --- a/generated/google-apis-admob_v1/google-apis-admob_v1.gemspec +++ b/generated/google-apis-admob_v1/google-apis-admob_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdmobV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for AdMob API V1" + gem.summary = "Simple REST client for AdMob API V1" gem.description = - "This is the legacy REST client for AdMob API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for AdMob API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-admob_v1beta/OVERVIEW.md b/generated/google-apis-admob_v1beta/OVERVIEW.md index 6493917c3..313275c42 100644 --- a/generated/google-apis-admob_v1beta/OVERVIEW.md +++ b/generated/google-apis-admob_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the AdMob API +# Simple REST client for version V1beta of the AdMob API This is a simple client library for version V1beta of the AdMob API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the AdMob API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Admob service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Admob service in particular.) For reference information on specific calls in the AdMob API, see the {Google::Apis::AdmobV1beta::AdMobService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-admob_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-admob_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/admob/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-admob_v1beta/google-apis-admob_v1beta.gemspec b/generated/google-apis-admob_v1beta/google-apis-admob_v1beta.gemspec index 7b719fcb1..7341d7b57 100644 --- a/generated/google-apis-admob_v1beta/google-apis-admob_v1beta.gemspec +++ b/generated/google-apis-admob_v1beta/google-apis-admob_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdmobV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for AdMob API V1beta" + gem.summary = "Simple REST client for AdMob API V1beta" gem.description = - "This is the legacy REST client for AdMob API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for AdMob API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adsense_v1_4/CHANGELOG.md b/generated/google-apis-adsense_v1_4/CHANGELOG.md index 6f2ea848e..c50643f0a 100644 --- a/generated/google-apis-adsense_v1_4/CHANGELOG.md +++ b/generated/google-apis-adsense_v1_4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adsense_v1_4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201002 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adsense_v1_4/OVERVIEW.md b/generated/google-apis-adsense_v1_4/OVERVIEW.md index eb6c310f3..8792d3c5c 100644 --- a/generated/google-apis-adsense_v1_4/OVERVIEW.md +++ b/generated/google-apis-adsense_v1_4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1_4 of the AdSense Management API +# Simple REST client for version V1_4 of the AdSense Management API This is a simple client library for version V1_4 of the AdSense Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1_4 of the AdSense Management API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adsense service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adsense service in particular.) For reference information on specific calls in the AdSense Management API, see the {Google::Apis::AdsenseV1_4::AdSenseService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adsense_v1_4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adsense_v1_4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/adsense/management/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adsense_v1_4/google-apis-adsense_v1_4.gemspec b/generated/google-apis-adsense_v1_4/google-apis-adsense_v1_4.gemspec index ec5327011..00c8b2684 100644 --- a/generated/google-apis-adsense_v1_4/google-apis-adsense_v1_4.gemspec +++ b/generated/google-apis-adsense_v1_4/google-apis-adsense_v1_4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdsenseV1_4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for AdSense Management API V1_4" + gem.summary = "Simple REST client for AdSense Management API V1_4" gem.description = - "This is the legacy REST client for AdSense Management API V1_4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for AdSense Management API V1_4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adsense_v1_4/lib/google/apis/adsense_v1_4/gem_version.rb b/generated/google-apis-adsense_v1_4/lib/google/apis/adsense_v1_4/gem_version.rb index a8b87066f..362bd9ecb 100644 --- a/generated/google-apis-adsense_v1_4/lib/google/apis/adsense_v1_4/gem_version.rb +++ b/generated/google-apis-adsense_v1_4/lib/google/apis/adsense_v1_4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201002" diff --git a/generated/google-apis-adsensehost_v4_1/CHANGELOG.md b/generated/google-apis-adsensehost_v4_1/CHANGELOG.md index 72d861a8f..5af5b6627 100644 --- a/generated/google-apis-adsensehost_v4_1/CHANGELOG.md +++ b/generated/google-apis-adsensehost_v4_1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-adsensehost_v4_1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200311 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-adsensehost_v4_1/OVERVIEW.md b/generated/google-apis-adsensehost_v4_1/OVERVIEW.md index 44ecd8ebb..8b32fac48 100644 --- a/generated/google-apis-adsensehost_v4_1/OVERVIEW.md +++ b/generated/google-apis-adsensehost_v4_1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V4_1 of the AdSense Host API +# Simple REST client for version V4_1 of the AdSense Host API This is a simple client library for version V4_1 of the AdSense Host API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V4_1 of the AdSense Host API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Adsensehost service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Adsensehost service in particular.) For reference information on specific calls in the AdSense Host API, see the {Google::Apis::AdsensehostV4_1::AdSenseHostService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-adsensehost_v4_1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-adsensehost_v4_1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/adsense/host/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-adsensehost_v4_1/google-apis-adsensehost_v4_1.gemspec b/generated/google-apis-adsensehost_v4_1/google-apis-adsensehost_v4_1.gemspec index 42108bb9c..6011dd576 100644 --- a/generated/google-apis-adsensehost_v4_1/google-apis-adsensehost_v4_1.gemspec +++ b/generated/google-apis-adsensehost_v4_1/google-apis-adsensehost_v4_1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AdsensehostV4_1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for AdSense Host API V4_1" + gem.summary = "Simple REST client for AdSense Host API V4_1" gem.description = - "This is the legacy REST client for AdSense Host API V4_1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for AdSense Host API V4_1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-adsensehost_v4_1/lib/google/apis/adsensehost_v4_1/gem_version.rb b/generated/google-apis-adsensehost_v4_1/lib/google/apis/adsensehost_v4_1/gem_version.rb index 517a2c0a9..373b5f6d4 100644 --- a/generated/google-apis-adsensehost_v4_1/lib/google/apis/adsensehost_v4_1/gem_version.rb +++ b/generated/google-apis-adsensehost_v4_1/lib/google/apis/adsensehost_v4_1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200311" diff --git a/generated/google-apis-alertcenter_v1beta1/OVERVIEW.md b/generated/google-apis-alertcenter_v1beta1/OVERVIEW.md index e36a2b1d9..4d225fc8e 100644 --- a/generated/google-apis-alertcenter_v1beta1/OVERVIEW.md +++ b/generated/google-apis-alertcenter_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Google Workspace Alert Center API +# Simple REST client for version V1beta1 of the Google Workspace Alert Center API This is a simple client library for version V1beta1 of the Google Workspace Alert Center API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Google Workspace Aler * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Alertcenter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Alertcenter service in particular.) For reference information on specific calls in the Google Workspace Alert Center API, see the {Google::Apis::AlertcenterV1beta1::AlertCenterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-alertcenter_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-alertcenter_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/admin-sdk/alertcenter/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-alertcenter_v1beta1/google-apis-alertcenter_v1beta1.gemspec b/generated/google-apis-alertcenter_v1beta1/google-apis-alertcenter_v1beta1.gemspec index 016eb80ee..757564c08 100644 --- a/generated/google-apis-alertcenter_v1beta1/google-apis-alertcenter_v1beta1.gemspec +++ b/generated/google-apis-alertcenter_v1beta1/google-apis-alertcenter_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AlertcenterV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Workspace Alert Center API V1beta1" + gem.summary = "Simple REST client for Google Workspace Alert Center API V1beta1" gem.description = - "This is the legacy REST client for Google Workspace Alert Center API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Workspace Alert Center API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-analytics_v3/CHANGELOG.md b/generated/google-apis-analytics_v3/CHANGELOG.md index c8afb2041..708930d0a 100644 --- a/generated/google-apis-analytics_v3/CHANGELOG.md +++ b/generated/google-apis-analytics_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-analytics_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20190807 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-analytics_v3/OVERVIEW.md b/generated/google-apis-analytics_v3/OVERVIEW.md index 91c38c985..fb83e05e1 100644 --- a/generated/google-apis-analytics_v3/OVERVIEW.md +++ b/generated/google-apis-analytics_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Google Analytics API +# Simple REST client for version V3 of the Google Analytics API This is a simple client library for version V3 of the Google Analytics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Google Analytics API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Analytics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Analytics service in particular.) For reference information on specific calls in the Google Analytics API, see the {Google::Apis::AnalyticsV3::AnalyticsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-analytics_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-analytics_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/analytics/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-analytics_v3/google-apis-analytics_v3.gemspec b/generated/google-apis-analytics_v3/google-apis-analytics_v3.gemspec index 7c52e50ee..e2b487fb9 100644 --- a/generated/google-apis-analytics_v3/google-apis-analytics_v3.gemspec +++ b/generated/google-apis-analytics_v3/google-apis-analytics_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AnalyticsV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Analytics API V3" + gem.summary = "Simple REST client for Google Analytics API V3" gem.description = - "This is the legacy REST client for Google Analytics API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Analytics API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-analytics_v3/lib/google/apis/analytics_v3/gem_version.rb b/generated/google-apis-analytics_v3/lib/google/apis/analytics_v3/gem_version.rb index de7060af5..6b1af4096 100644 --- a/generated/google-apis-analytics_v3/lib/google/apis/analytics_v3/gem_version.rb +++ b/generated/google-apis-analytics_v3/lib/google/apis/analytics_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20190807" diff --git a/generated/google-apis-analyticsadmin_v1alpha/CHANGELOG.md b/generated/google-apis-analyticsadmin_v1alpha/CHANGELOG.md index 066332ea5..296b41879 100644 --- a/generated/google-apis-analyticsadmin_v1alpha/CHANGELOG.md +++ b/generated/google-apis-analyticsadmin_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-analyticsadmin_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20210106 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-analyticsadmin_v1alpha/OVERVIEW.md b/generated/google-apis-analyticsadmin_v1alpha/OVERVIEW.md index 16c665c0f..99f5ded49 100644 --- a/generated/google-apis-analyticsadmin_v1alpha/OVERVIEW.md +++ b/generated/google-apis-analyticsadmin_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Google Analytics Admin API +# Simple REST client for version V1alpha of the Google Analytics Admin API This is a simple client library for version V1alpha of the Google Analytics Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Google Analytics Admi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Analyticsadmin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Analyticsadmin service in particular.) For reference information on specific calls in the Google Analytics Admin API, see the {Google::Apis::AnalyticsadminV1alpha::GoogleAnalyticsAdminService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-analyticsadmin_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-analyticsadmin_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://code.google.com/apis/analytics/docs/mgmt/home.html) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-analyticsadmin_v1alpha/google-apis-analyticsadmin_v1alpha.gemspec b/generated/google-apis-analyticsadmin_v1alpha/google-apis-analyticsadmin_v1alpha.gemspec index 3edabbaef..15318aaa7 100644 --- a/generated/google-apis-analyticsadmin_v1alpha/google-apis-analyticsadmin_v1alpha.gemspec +++ b/generated/google-apis-analyticsadmin_v1alpha/google-apis-analyticsadmin_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AnalyticsadminV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Analytics Admin API V1alpha" + gem.summary = "Simple REST client for Google Analytics Admin API V1alpha" gem.description = - "This is the legacy REST client for Google Analytics Admin API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Analytics Admin API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/gem_version.rb b/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/gem_version.rb index 565860c4a..810ae1ea7 100644 --- a/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/gem_version.rb +++ b/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201213" + REVISION = "20210106" end end end diff --git a/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/service.rb b/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/service.rb index c19b27840..c01906170 100644 --- a/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/service.rb +++ b/generated/google-apis-analyticsadmin_v1alpha/lib/google/apis/analyticsadmin_v1alpha/service.rb @@ -761,11 +761,11 @@ module Google # Required. An expression for filtering the results of the request. Fields # eligible for filtering are: `parent:`(The resource name of the parent account) # or `firebase_project:`(The id or number of the linked firebase project). Some - # examples of filters: | Filter | Description | |-----------------------------|-- - # -----------------------------------------| | parent:accounts/123 | The account - # with account id: 123. | | firebase_project:project-id | The firebase project - # with id: project-id. | | firebase_project:123 | The firebase project with - # number: 123. | + # examples of filters: ``` | Filter | Description | |---------------------------- + # -|-------------------------------------------| | parent:accounts/123 | The + # account with account id: 123. | | firebase_project:project-id | The firebase + # project with id: project-id. | | firebase_project:123 | The firebase project + # with number: 123. | ``` # @param [Fixnum] page_size # The maximum number of resources to return. The service may return fewer than # this value, even if there are additional pages. If unspecified, at most 50 diff --git a/generated/google-apis-analyticsdata_v1alpha/OVERVIEW.md b/generated/google-apis-analyticsdata_v1alpha/OVERVIEW.md index 5de131b32..8147b47d7 100644 --- a/generated/google-apis-analyticsdata_v1alpha/OVERVIEW.md +++ b/generated/google-apis-analyticsdata_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Google Analytics Data API +# Simple REST client for version V1alpha of the Google Analytics Data API This is a simple client library for version V1alpha of the Google Analytics Data API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Google Analytics Data * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Analyticsdata service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Analyticsdata service in particular.) For reference information on specific calls in the Google Analytics Data API, see the {Google::Apis::AnalyticsdataV1alpha::AnalyticsDataService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-analyticsdata_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-analyticsdata_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/analytics/devguides/reporting/data/v1/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-analyticsdata_v1alpha/google-apis-analyticsdata_v1alpha.gemspec b/generated/google-apis-analyticsdata_v1alpha/google-apis-analyticsdata_v1alpha.gemspec index db4cb6ffa..90bd9d9f6 100644 --- a/generated/google-apis-analyticsdata_v1alpha/google-apis-analyticsdata_v1alpha.gemspec +++ b/generated/google-apis-analyticsdata_v1alpha/google-apis-analyticsdata_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AnalyticsdataV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Analytics Data API V1alpha" + gem.summary = "Simple REST client for Google Analytics Data API V1alpha" gem.description = - "This is the legacy REST client for Google Analytics Data API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Analytics Data API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-analyticsreporting_v4/OVERVIEW.md b/generated/google-apis-analyticsreporting_v4/OVERVIEW.md index 1d85b45d9..fae135d56 100644 --- a/generated/google-apis-analyticsreporting_v4/OVERVIEW.md +++ b/generated/google-apis-analyticsreporting_v4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V4 of the Analytics Reporting API +# Simple REST client for version V4 of the Analytics Reporting API This is a simple client library for version V4 of the Analytics Reporting API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V4 of the Analytics Reporting API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Analyticsreporting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Analyticsreporting service in particular.) For reference information on specific calls in the Analytics Reporting API, see the {Google::Apis::AnalyticsreportingV4::AnalyticsReportingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-analyticsreporting_v4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-analyticsreporting_v4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/analytics/devguides/reporting/core/v4/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-analyticsreporting_v4/google-apis-analyticsreporting_v4.gemspec b/generated/google-apis-analyticsreporting_v4/google-apis-analyticsreporting_v4.gemspec index 1d611a507..eb28f47eb 100644 --- a/generated/google-apis-analyticsreporting_v4/google-apis-analyticsreporting_v4.gemspec +++ b/generated/google-apis-analyticsreporting_v4/google-apis-analyticsreporting_v4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AnalyticsreportingV4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Analytics Reporting API V4" + gem.summary = "Simple REST client for Analytics Reporting API V4" gem.description = - "This is the legacy REST client for Analytics Reporting API V4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Analytics Reporting API V4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-androiddeviceprovisioning_v1/CHANGELOG.md b/generated/google-apis-androiddeviceprovisioning_v1/CHANGELOG.md index e97105510..8c5e027e8 100644 --- a/generated/google-apis-androiddeviceprovisioning_v1/CHANGELOG.md +++ b/generated/google-apis-androiddeviceprovisioning_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-androiddeviceprovisioning_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-androiddeviceprovisioning_v1/OVERVIEW.md b/generated/google-apis-androiddeviceprovisioning_v1/OVERVIEW.md index 86f9efaa1..fd32994dc 100644 --- a/generated/google-apis-androiddeviceprovisioning_v1/OVERVIEW.md +++ b/generated/google-apis-androiddeviceprovisioning_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Android Device Provisioning Partner API +# Simple REST client for version V1 of the Android Device Provisioning Partner API This is a simple client library for version V1 of the Android Device Provisioning Partner API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Android Device Provisionin * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Androiddeviceprovisioning service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Androiddeviceprovisioning service in particular.) For reference information on specific calls in the Android Device Provisioning Partner API, see the {Google::Apis::AndroiddeviceprovisioningV1::AndroidProvisioningPartnerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-androiddeviceprovisioning_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-androiddeviceprovisioning_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/zero-touch/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-androiddeviceprovisioning_v1/google-apis-androiddeviceprovisioning_v1.gemspec b/generated/google-apis-androiddeviceprovisioning_v1/google-apis-androiddeviceprovisioning_v1.gemspec index ede2ec87d..d774e8bec 100644 --- a/generated/google-apis-androiddeviceprovisioning_v1/google-apis-androiddeviceprovisioning_v1.gemspec +++ b/generated/google-apis-androiddeviceprovisioning_v1/google-apis-androiddeviceprovisioning_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AndroiddeviceprovisioningV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Android Device Provisioning Partner API V1" + gem.summary = "Simple REST client for Android Device Provisioning Partner API V1" gem.description = - "This is the legacy REST client for Android Device Provisioning Partner API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Android Device Provisioning Partner API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-androiddeviceprovisioning_v1/lib/google/apis/androiddeviceprovisioning_v1/gem_version.rb b/generated/google-apis-androiddeviceprovisioning_v1/lib/google/apis/androiddeviceprovisioning_v1/gem_version.rb index cd77db97d..b53e6e7f8 100644 --- a/generated/google-apis-androiddeviceprovisioning_v1/lib/google/apis/androiddeviceprovisioning_v1/gem_version.rb +++ b/generated/google-apis-androiddeviceprovisioning_v1/lib/google/apis/androiddeviceprovisioning_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-androidenterprise_v1/CHANGELOG.md b/generated/google-apis-androidenterprise_v1/CHANGELOG.md index d9fa51edc..244b0fdaa 100644 --- a/generated/google-apis-androidenterprise_v1/CHANGELOG.md +++ b/generated/google-apis-androidenterprise_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-androidenterprise_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201125 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-androidenterprise_v1/OVERVIEW.md b/generated/google-apis-androidenterprise_v1/OVERVIEW.md index e9fbe3873..22987e8be 100644 --- a/generated/google-apis-androidenterprise_v1/OVERVIEW.md +++ b/generated/google-apis-androidenterprise_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Play EMM API +# Simple REST client for version V1 of the Google Play EMM API This is a simple client library for version V1 of the Google Play EMM API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Play EMM API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Androidenterprise service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Androidenterprise service in particular.) For reference information on specific calls in the Google Play EMM API, see the {Google::Apis::AndroidenterpriseV1::AndroidEnterpriseService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-androidenterprise_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-androidenterprise_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/android/work/play/emm-api) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-androidenterprise_v1/google-apis-androidenterprise_v1.gemspec b/generated/google-apis-androidenterprise_v1/google-apis-androidenterprise_v1.gemspec index b561acffc..82822d982 100644 --- a/generated/google-apis-androidenterprise_v1/google-apis-androidenterprise_v1.gemspec +++ b/generated/google-apis-androidenterprise_v1/google-apis-androidenterprise_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AndroidenterpriseV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play EMM API V1" + gem.summary = "Simple REST client for Google Play EMM API V1" gem.description = - "This is the legacy REST client for Google Play EMM API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play EMM API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-androidenterprise_v1/lib/google/apis/androidenterprise_v1/gem_version.rb b/generated/google-apis-androidenterprise_v1/lib/google/apis/androidenterprise_v1/gem_version.rb index ffa3113b6..dfffbea92 100644 --- a/generated/google-apis-androidenterprise_v1/lib/google/apis/androidenterprise_v1/gem_version.rb +++ b/generated/google-apis-androidenterprise_v1/lib/google/apis/androidenterprise_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201125" diff --git a/generated/google-apis-androidmanagement_v1/CHANGELOG.md b/generated/google-apis-androidmanagement_v1/CHANGELOG.md index df290f20a..0e79f190a 100644 --- a/generated/google-apis-androidmanagement_v1/CHANGELOG.md +++ b/generated/google-apis-androidmanagement_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-androidmanagement_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201209 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-androidmanagement_v1/OVERVIEW.md b/generated/google-apis-androidmanagement_v1/OVERVIEW.md index 39b159744..bd52f291a 100644 --- a/generated/google-apis-androidmanagement_v1/OVERVIEW.md +++ b/generated/google-apis-androidmanagement_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Android Management API +# Simple REST client for version V1 of the Android Management API This is a simple client library for version V1 of the Android Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Android Management API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Androidmanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Androidmanagement service in particular.) For reference information on specific calls in the Android Management API, see the {Google::Apis::AndroidmanagementV1::AndroidManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-androidmanagement_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-androidmanagement_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/android/management) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-androidmanagement_v1/google-apis-androidmanagement_v1.gemspec b/generated/google-apis-androidmanagement_v1/google-apis-androidmanagement_v1.gemspec index 1a45cbb11..ab0f7de3b 100644 --- a/generated/google-apis-androidmanagement_v1/google-apis-androidmanagement_v1.gemspec +++ b/generated/google-apis-androidmanagement_v1/google-apis-androidmanagement_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AndroidmanagementV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Android Management API V1" + gem.summary = "Simple REST client for Android Management API V1" gem.description = - "This is the legacy REST client for Android Management API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Android Management API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-androidmanagement_v1/lib/google/apis/androidmanagement_v1/gem_version.rb b/generated/google-apis-androidmanagement_v1/lib/google/apis/androidmanagement_v1/gem_version.rb index e8b067692..125271139 100644 --- a/generated/google-apis-androidmanagement_v1/lib/google/apis/androidmanagement_v1/gem_version.rb +++ b/generated/google-apis-androidmanagement_v1/lib/google/apis/androidmanagement_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201209" diff --git a/generated/google-apis-androidpublisher_v3/CHANGELOG.md b/generated/google-apis-androidpublisher_v3/CHANGELOG.md index 647e88116..e436c7708 100644 --- a/generated/google-apis-androidpublisher_v3/CHANGELOG.md +++ b/generated/google-apis-androidpublisher_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-androidpublisher_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201125 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-androidpublisher_v3/OVERVIEW.md b/generated/google-apis-androidpublisher_v3/OVERVIEW.md index 11dedc91f..dbc51617b 100644 --- a/generated/google-apis-androidpublisher_v3/OVERVIEW.md +++ b/generated/google-apis-androidpublisher_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Google Play Android Developer API +# Simple REST client for version V3 of the Google Play Android Developer API This is a simple client library for version V3 of the Google Play Android Developer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Google Play Android Develo * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Androidpublisher service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Androidpublisher service in particular.) For reference information on specific calls in the Google Play Android Developer API, see the {Google::Apis::AndroidpublisherV3::AndroidPublisherService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-androidpublisher_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-androidpublisher_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/android-publisher) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-androidpublisher_v3/google-apis-androidpublisher_v3.gemspec b/generated/google-apis-androidpublisher_v3/google-apis-androidpublisher_v3.gemspec index 366d4066a..ea5c33016 100644 --- a/generated/google-apis-androidpublisher_v3/google-apis-androidpublisher_v3.gemspec +++ b/generated/google-apis-androidpublisher_v3/google-apis-androidpublisher_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AndroidpublisherV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play Android Developer API V3" + gem.summary = "Simple REST client for Google Play Android Developer API V3" gem.description = - "This is the legacy REST client for Google Play Android Developer API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play Android Developer API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-androidpublisher_v3/lib/google/apis/androidpublisher_v3/gem_version.rb b/generated/google-apis-androidpublisher_v3/lib/google/apis/androidpublisher_v3/gem_version.rb index 530e8a8db..54c1d5ea7 100644 --- a/generated/google-apis-androidpublisher_v3/lib/google/apis/androidpublisher_v3/gem_version.rb +++ b/generated/google-apis-androidpublisher_v3/lib/google/apis/androidpublisher_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201125" diff --git a/generated/google-apis-apigateway_v1/CHANGELOG.md b/generated/google-apis-apigateway_v1/CHANGELOG.md index 200931334..0f3fc9403 100644 --- a/generated/google-apis-apigateway_v1/CHANGELOG.md +++ b/generated/google-apis-apigateway_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-apigateway_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-apigateway_v1/OVERVIEW.md b/generated/google-apis-apigateway_v1/OVERVIEW.md index 49782c26f..7514e78dd 100644 --- a/generated/google-apis-apigateway_v1/OVERVIEW.md +++ b/generated/google-apis-apigateway_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the API Gateway API +# Simple REST client for version V1 of the API Gateway API This is a simple client library for version V1 of the API Gateway API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the API Gateway API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Apigateway service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Apigateway service in particular.) For reference information on specific calls in the API Gateway API, see the {Google::Apis::ApigatewayV1::ApigatewayService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-apigateway_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-apigateway_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation]( https://cloud.google.com/api-gateway/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-apigateway_v1/google-apis-apigateway_v1.gemspec b/generated/google-apis-apigateway_v1/google-apis-apigateway_v1.gemspec index 6549530fe..71f2cbc82 100644 --- a/generated/google-apis-apigateway_v1/google-apis-apigateway_v1.gemspec +++ b/generated/google-apis-apigateway_v1/google-apis-apigateway_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ApigatewayV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for API Gateway API V1" + gem.summary = "Simple REST client for API Gateway API V1" gem.description = - "This is the legacy REST client for API Gateway API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for API Gateway API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-apigateway_v1/lib/google/apis/apigateway_v1/gem_version.rb b/generated/google-apis-apigateway_v1/lib/google/apis/apigateway_v1/gem_version.rb index 8948bcd30..54140c051 100644 --- a/generated/google-apis-apigateway_v1/lib/google/apis/apigateway_v1/gem_version.rb +++ b/generated/google-apis-apigateway_v1/lib/google/apis/apigateway_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-apigateway_v1beta/CHANGELOG.md b/generated/google-apis-apigateway_v1beta/CHANGELOG.md index f8caf8550..d52b328a3 100644 --- a/generated/google-apis-apigateway_v1beta/CHANGELOG.md +++ b/generated/google-apis-apigateway_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-apigateway_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-apigateway_v1beta/OVERVIEW.md b/generated/google-apis-apigateway_v1beta/OVERVIEW.md index bbe2c975b..7bc67bfcc 100644 --- a/generated/google-apis-apigateway_v1beta/OVERVIEW.md +++ b/generated/google-apis-apigateway_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the API Gateway API +# Simple REST client for version V1beta of the API Gateway API This is a simple client library for version V1beta of the API Gateway API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the API Gateway API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Apigateway service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Apigateway service in particular.) For reference information on specific calls in the API Gateway API, see the {Google::Apis::ApigatewayV1beta::ApigatewayService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-apigateway_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-apigateway_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation]( https://cloud.google.com/api-gateway/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-apigateway_v1beta/google-apis-apigateway_v1beta.gemspec b/generated/google-apis-apigateway_v1beta/google-apis-apigateway_v1beta.gemspec index 3318f4439..983458f27 100644 --- a/generated/google-apis-apigateway_v1beta/google-apis-apigateway_v1beta.gemspec +++ b/generated/google-apis-apigateway_v1beta/google-apis-apigateway_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ApigatewayV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for API Gateway API V1beta" + gem.summary = "Simple REST client for API Gateway API V1beta" gem.description = - "This is the legacy REST client for API Gateway API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for API Gateway API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-apigateway_v1beta/lib/google/apis/apigateway_v1beta/gem_version.rb b/generated/google-apis-apigateway_v1beta/lib/google/apis/apigateway_v1beta/gem_version.rb index 02a648f44..4946682dc 100644 --- a/generated/google-apis-apigateway_v1beta/lib/google/apis/apigateway_v1beta/gem_version.rb +++ b/generated/google-apis-apigateway_v1beta/lib/google/apis/apigateway_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-apigee_v1/OVERVIEW.md b/generated/google-apis-apigee_v1/OVERVIEW.md index 2f2873390..a68e6a15e 100644 --- a/generated/google-apis-apigee_v1/OVERVIEW.md +++ b/generated/google-apis-apigee_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Apigee API +# Simple REST client for version V1 of the Apigee API This is a simple client library for version V1 of the Apigee API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Apigee API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Apigee service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Apigee service in particular.) For reference information on specific calls in the Apigee API, see the {Google::Apis::ApigeeV1::ApigeeService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-apigee_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-apigee_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/apigee-api-management/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-apigee_v1/google-apis-apigee_v1.gemspec b/generated/google-apis-apigee_v1/google-apis-apigee_v1.gemspec index 4c2e51bde..7d0dce8b0 100644 --- a/generated/google-apis-apigee_v1/google-apis-apigee_v1.gemspec +++ b/generated/google-apis-apigee_v1/google-apis-apigee_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ApigeeV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Apigee API V1" + gem.summary = "Simple REST client for Apigee API V1" gem.description = - "This is the legacy REST client for Apigee API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Apigee API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1/CHANGELOG.md b/generated/google-apis-appengine_v1/CHANGELOG.md index f50eadb7b..5f19eb8b2 100644 --- a/generated/google-apis-appengine_v1/CHANGELOG.md +++ b/generated/google-apis-appengine_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appengine_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-appengine_v1/OVERVIEW.md b/generated/google-apis-appengine_v1/OVERVIEW.md index e11a9cc3a..49e3bfb3e 100644 --- a/generated/google-apis-appengine_v1/OVERVIEW.md +++ b/generated/google-apis-appengine_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the App Engine Admin API +# Simple REST client for version V1 of the App Engine Admin API This is a simple client library for version V1 of the App Engine Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the App Engine Admin API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appengine service in particular.) For reference information on specific calls in the App Engine Admin API, see the {Google::Apis::AppengineV1::AppengineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appengine_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appengine_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/appengine/docs/admin-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appengine_v1/google-apis-appengine_v1.gemspec b/generated/google-apis-appengine_v1/google-apis-appengine_v1.gemspec index 8551dc301..3661a26bd 100644 --- a/generated/google-apis-appengine_v1/google-apis-appengine_v1.gemspec +++ b/generated/google-apis-appengine_v1/google-apis-appengine_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppengineV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for App Engine Admin API V1" + gem.summary = "Simple REST client for App Engine Admin API V1" gem.description = - "This is the legacy REST client for App Engine Admin API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for App Engine Admin API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1/lib/google/apis/appengine_v1/gem_version.rb b/generated/google-apis-appengine_v1/lib/google/apis/appengine_v1/gem_version.rb index 9ac7ab184..ad1f74c75 100644 --- a/generated/google-apis-appengine_v1/lib/google/apis/appengine_v1/gem_version.rb +++ b/generated/google-apis-appengine_v1/lib/google/apis/appengine_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-appengine_v1alpha/CHANGELOG.md b/generated/google-apis-appengine_v1alpha/CHANGELOG.md index fd72ba449..58e989669 100644 --- a/generated/google-apis-appengine_v1alpha/CHANGELOG.md +++ b/generated/google-apis-appengine_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appengine_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200802 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-appengine_v1alpha/OVERVIEW.md b/generated/google-apis-appengine_v1alpha/OVERVIEW.md index d69395f9f..e46c95839 100644 --- a/generated/google-apis-appengine_v1alpha/OVERVIEW.md +++ b/generated/google-apis-appengine_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the App Engine Admin API +# Simple REST client for version V1alpha of the App Engine Admin API This is a simple client library for version V1alpha of the App Engine Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the App Engine Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appengine service in particular.) For reference information on specific calls in the App Engine Admin API, see the {Google::Apis::AppengineV1alpha::AppengineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appengine_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appengine_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/appengine/docs/admin-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appengine_v1alpha/google-apis-appengine_v1alpha.gemspec b/generated/google-apis-appengine_v1alpha/google-apis-appengine_v1alpha.gemspec index 4e70fc8ff..3b65900e7 100644 --- a/generated/google-apis-appengine_v1alpha/google-apis-appengine_v1alpha.gemspec +++ b/generated/google-apis-appengine_v1alpha/google-apis-appengine_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppengineV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for App Engine Admin API V1alpha" + gem.summary = "Simple REST client for App Engine Admin API V1alpha" gem.description = - "This is the legacy REST client for App Engine Admin API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for App Engine Admin API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1alpha/lib/google/apis/appengine_v1alpha/gem_version.rb b/generated/google-apis-appengine_v1alpha/lib/google/apis/appengine_v1alpha/gem_version.rb index bdffd2047..d79d6d2f1 100644 --- a/generated/google-apis-appengine_v1alpha/lib/google/apis/appengine_v1alpha/gem_version.rb +++ b/generated/google-apis-appengine_v1alpha/lib/google/apis/appengine_v1alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200802" diff --git a/generated/google-apis-appengine_v1beta/CHANGELOG.md b/generated/google-apis-appengine_v1beta/CHANGELOG.md index c4c4368c4..ddd8a44e3 100644 --- a/generated/google-apis-appengine_v1beta/CHANGELOG.md +++ b/generated/google-apis-appengine_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appengine_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201114 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-appengine_v1beta/OVERVIEW.md b/generated/google-apis-appengine_v1beta/OVERVIEW.md index e3b1d4909..71c7470af 100644 --- a/generated/google-apis-appengine_v1beta/OVERVIEW.md +++ b/generated/google-apis-appengine_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the App Engine Admin API +# Simple REST client for version V1beta of the App Engine Admin API This is a simple client library for version V1beta of the App Engine Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the App Engine Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appengine service in particular.) For reference information on specific calls in the App Engine Admin API, see the {Google::Apis::AppengineV1beta::AppengineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appengine_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appengine_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/appengine/docs/admin-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appengine_v1beta/google-apis-appengine_v1beta.gemspec b/generated/google-apis-appengine_v1beta/google-apis-appengine_v1beta.gemspec index d36a23487..3386aa7a2 100644 --- a/generated/google-apis-appengine_v1beta/google-apis-appengine_v1beta.gemspec +++ b/generated/google-apis-appengine_v1beta/google-apis-appengine_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppengineV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for App Engine Admin API V1beta" + gem.summary = "Simple REST client for App Engine Admin API V1beta" gem.description = - "This is the legacy REST client for App Engine Admin API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for App Engine Admin API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1beta/lib/google/apis/appengine_v1beta/gem_version.rb b/generated/google-apis-appengine_v1beta/lib/google/apis/appengine_v1beta/gem_version.rb index 58bfb592d..71d16cd1f 100644 --- a/generated/google-apis-appengine_v1beta/lib/google/apis/appengine_v1beta/gem_version.rb +++ b/generated/google-apis-appengine_v1beta/lib/google/apis/appengine_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201114" diff --git a/generated/google-apis-appengine_v1beta4/CHANGELOG.md b/generated/google-apis-appengine_v1beta4/CHANGELOG.md index e546b4d0f..0cf04d560 100644 --- a/generated/google-apis-appengine_v1beta4/CHANGELOG.md +++ b/generated/google-apis-appengine_v1beta4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appengine_v1beta4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20181218 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-appengine_v1beta4/OVERVIEW.md b/generated/google-apis-appengine_v1beta4/OVERVIEW.md index 6e28f040e..bb05d361e 100644 --- a/generated/google-apis-appengine_v1beta4/OVERVIEW.md +++ b/generated/google-apis-appengine_v1beta4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta4 of the App Engine Admin API +# Simple REST client for version V1beta4 of the App Engine Admin API This is a simple client library for version V1beta4 of the App Engine Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta4 of the App Engine Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appengine service in particular.) For reference information on specific calls in the App Engine Admin API, see the {Google::Apis::AppengineV1beta4::AppengineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appengine_v1beta4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appengine_v1beta4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/appengine/docs/admin-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appengine_v1beta4/google-apis-appengine_v1beta4.gemspec b/generated/google-apis-appengine_v1beta4/google-apis-appengine_v1beta4.gemspec index f33fe0931..f8d7e7e36 100644 --- a/generated/google-apis-appengine_v1beta4/google-apis-appengine_v1beta4.gemspec +++ b/generated/google-apis-appengine_v1beta4/google-apis-appengine_v1beta4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppengineV1beta4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for App Engine Admin API V1beta4" + gem.summary = "Simple REST client for App Engine Admin API V1beta4" gem.description = - "This is the legacy REST client for App Engine Admin API V1beta4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for App Engine Admin API V1beta4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1beta4/lib/google/apis/appengine_v1beta4/gem_version.rb b/generated/google-apis-appengine_v1beta4/lib/google/apis/appengine_v1beta4/gem_version.rb index 076039055..b22539301 100644 --- a/generated/google-apis-appengine_v1beta4/lib/google/apis/appengine_v1beta4/gem_version.rb +++ b/generated/google-apis-appengine_v1beta4/lib/google/apis/appengine_v1beta4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20181218" diff --git a/generated/google-apis-appengine_v1beta5/CHANGELOG.md b/generated/google-apis-appengine_v1beta5/CHANGELOG.md index 1c4ab65c7..6afcac052 100644 --- a/generated/google-apis-appengine_v1beta5/CHANGELOG.md +++ b/generated/google-apis-appengine_v1beta5/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appengine_v1beta5 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20181218 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-appengine_v1beta5/OVERVIEW.md b/generated/google-apis-appengine_v1beta5/OVERVIEW.md index b5e15e99d..9976054d3 100644 --- a/generated/google-apis-appengine_v1beta5/OVERVIEW.md +++ b/generated/google-apis-appengine_v1beta5/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta5 of the App Engine Admin API +# Simple REST client for version V1beta5 of the App Engine Admin API This is a simple client library for version V1beta5 of the App Engine Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta5 of the App Engine Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appengine service in particular.) For reference information on specific calls in the App Engine Admin API, see the {Google::Apis::AppengineV1beta5::AppengineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appengine_v1beta5`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appengine_v1beta5`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/appengine/docs/admin-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appengine_v1beta5/google-apis-appengine_v1beta5.gemspec b/generated/google-apis-appengine_v1beta5/google-apis-appengine_v1beta5.gemspec index f0fa93c5e..8d0837bdf 100644 --- a/generated/google-apis-appengine_v1beta5/google-apis-appengine_v1beta5.gemspec +++ b/generated/google-apis-appengine_v1beta5/google-apis-appengine_v1beta5.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppengineV1beta5::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for App Engine Admin API V1beta5" + gem.summary = "Simple REST client for App Engine Admin API V1beta5" gem.description = - "This is the legacy REST client for App Engine Admin API V1beta5." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for App Engine Admin API V1beta5." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appengine_v1beta5/lib/google/apis/appengine_v1beta5/gem_version.rb b/generated/google-apis-appengine_v1beta5/lib/google/apis/appengine_v1beta5/gem_version.rb index f4120226b..4a02b2c83 100644 --- a/generated/google-apis-appengine_v1beta5/lib/google/apis/appengine_v1beta5/gem_version.rb +++ b/generated/google-apis-appengine_v1beta5/lib/google/apis/appengine_v1beta5/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20181218" diff --git a/generated/google-apis-appsmarket_v2/CHANGELOG.md b/generated/google-apis-appsmarket_v2/CHANGELOG.md index 3d99e4d86..9716323ad 100644 --- a/generated/google-apis-appsmarket_v2/CHANGELOG.md +++ b/generated/google-apis-appsmarket_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-appsmarket_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20210104 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-appsmarket_v2/OVERVIEW.md b/generated/google-apis-appsmarket_v2/OVERVIEW.md index e47e866e5..3888d329f 100644 --- a/generated/google-apis-appsmarket_v2/OVERVIEW.md +++ b/generated/google-apis-appsmarket_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the G Suite Marketplace API +# Simple REST client for version V2 of the G Suite Marketplace API This is a simple client library for version V2 of the G Suite Marketplace API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the G Suite Marketplace API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -48,7 +48,7 @@ Once the gem is installed, you can load the client code and instantiate a client require "google/apis/appsmarket_v2" # Create a client object -client = Google::Apis::AppsmarketV2::GSuiteMarketplaceAPIService.new +client = Google::Apis::AppsmarketV2::GoogleWorkspaceMarketplaceAPIService.new # Authenticate calls client.authentication = # ... use the googleauth gem to create credentials @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Appsmarket service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Appsmarket service in particular.) -For reference information on specific calls in the G Suite Marketplace API, see the {Google::Apis::AppsmarketV2::GSuiteMarketplaceAPIService class reference docs}. +For reference information on specific calls in the G Suite Marketplace API, see the {Google::Apis::AppsmarketV2::GoogleWorkspaceMarketplaceAPIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-appsmarket_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-appsmarket_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/apps-marketplace) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-appsmarket_v2/google-apis-appsmarket_v2.gemspec b/generated/google-apis-appsmarket_v2/google-apis-appsmarket_v2.gemspec index f8257deef..315ad85a0 100644 --- a/generated/google-apis-appsmarket_v2/google-apis-appsmarket_v2.gemspec +++ b/generated/google-apis-appsmarket_v2/google-apis-appsmarket_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AppsmarketV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for G Suite Marketplace API V2" + gem.summary = "Simple REST client for G Suite Marketplace API V2" gem.description = - "This is the legacy REST client for G Suite Marketplace API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for G Suite Marketplace API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2.rb b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2.rb index 1dcda0140..602b8959a 100644 --- a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2.rb +++ b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2.rb @@ -21,8 +21,8 @@ module Google module Apis # G Suite Marketplace API # - # Lets your G Suite Marketplace applications integrate with Google's licensing - # and billing services. + # Lets your Google Workspace Marketplace applications integrate with Google's + # licensing and billing services. # # @see https://developers.google.com/apps-marketplace module AppsmarketV2 diff --git a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/gem_version.rb b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/gem_version.rb index 91eaa929d..13a6fb916 100644 --- a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/gem_version.rb +++ b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201207" + REVISION = "20210104" end end end diff --git a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/service.rb b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/service.rb index defb86541..763af1adf 100644 --- a/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/service.rb +++ b/generated/google-apis-appsmarket_v2/lib/google/apis/appsmarket_v2/service.rb @@ -22,17 +22,17 @@ module Google module AppsmarketV2 # G Suite Marketplace API # - # Lets your G Suite Marketplace applications integrate with Google's licensing - # and billing services. + # Lets your Google Workspace Marketplace applications integrate with Google's + # licensing and billing services. # # @example # require 'google/apis/appsmarket_v2' # # Appsmarket = Google::Apis::AppsmarketV2 # Alias the module - # service = Appsmarket::GSuiteMarketplaceAPIService.new + # service = Appsmarket::GoogleWorkspaceMarketplaceAPIService.new # # @see https://developers.google.com/apps-marketplace - class GSuiteMarketplaceAPIService < Google::Apis::Core::BaseService + class GoogleWorkspaceMarketplaceAPIService < Google::Apis::Core::BaseService # @return [String] # 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. diff --git a/generated/google-apis-appsmarket_v2/spec/generated_spec.rb b/generated/google-apis-appsmarket_v2/spec/generated_spec.rb index a7ba0154f..39a65110a 100644 --- a/generated/google-apis-appsmarket_v2/spec/generated_spec.rb +++ b/generated/google-apis-appsmarket_v2/spec/generated_spec.rb @@ -21,7 +21,7 @@ RSpec.describe "Google::Apis::AppsmarketV2" do require "google/apis/appsmarket_v2" end.not_to raise_error expect do - Google::Apis::AppsmarketV2::GSuiteMarketplaceAPIService.new + Google::Apis::AppsmarketV2::GoogleWorkspaceMarketplaceAPIService.new end.not_to raise_error end end diff --git a/generated/google-apis-area120tables_v1alpha1/CHANGELOG.md b/generated/google-apis-area120tables_v1alpha1/CHANGELOG.md index 326971777..96ebbb89b 100644 --- a/generated/google-apis-area120tables_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-area120tables_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-area120tables_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-area120tables_v1alpha1/OVERVIEW.md b/generated/google-apis-area120tables_v1alpha1/OVERVIEW.md index fb46018a2..fbc397a39 100644 --- a/generated/google-apis-area120tables_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-area120tables_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Area120 Tables API +# Simple REST client for version V1alpha1 of the Area120 Tables API This is a simple client library for version V1alpha1 of the Area120 Tables API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Area120 Tables API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Area120tables service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Area120tables service in particular.) For reference information on specific calls in the Area120 Tables API, see the {Google::Apis::Area120tablesV1alpha1::Area120TablesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-area120tables_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-area120tables_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://tables.area120.google.com) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-area120tables_v1alpha1/google-apis-area120tables_v1alpha1.gemspec b/generated/google-apis-area120tables_v1alpha1/google-apis-area120tables_v1alpha1.gemspec index 7ab81e705..e81c82147 100644 --- a/generated/google-apis-area120tables_v1alpha1/google-apis-area120tables_v1alpha1.gemspec +++ b/generated/google-apis-area120tables_v1alpha1/google-apis-area120tables_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::Area120tablesV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Area120 Tables API V1alpha1" + gem.summary = "Simple REST client for Area120 Tables API V1alpha1" gem.description = - "This is the legacy REST client for Area120 Tables API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Area120 Tables API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-area120tables_v1alpha1/lib/google/apis/area120tables_v1alpha1/gem_version.rb b/generated/google-apis-area120tables_v1alpha1/lib/google/apis/area120tables_v1alpha1/gem_version.rb index 3d4584b23..09a3f4779 100644 --- a/generated/google-apis-area120tables_v1alpha1/lib/google/apis/area120tables_v1alpha1/gem_version.rb +++ b/generated/google-apis-area120tables_v1alpha1/lib/google/apis/area120tables_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-artifactregistry_v1/CHANGELOG.md b/generated/google-apis-artifactregistry_v1/CHANGELOG.md index 05b9e5a7e..668faa67b 100644 --- a/generated/google-apis-artifactregistry_v1/CHANGELOG.md +++ b/generated/google-apis-artifactregistry_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-artifactregistry_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201215 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-artifactregistry_v1/OVERVIEW.md b/generated/google-apis-artifactregistry_v1/OVERVIEW.md index 2c7ded245..a8c499952 100644 --- a/generated/google-apis-artifactregistry_v1/OVERVIEW.md +++ b/generated/google-apis-artifactregistry_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Artifact Registry API +# Simple REST client for version V1 of the Artifact Registry API This is a simple client library for version V1 of the Artifact Registry API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Artifact Registry API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Artifactregistry service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Artifactregistry service in particular.) For reference information on specific calls in the Artifact Registry API, see the {Google::Apis::ArtifactregistryV1::ArtifactRegistryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-artifactregistry_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-artifactregistry_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/artifacts/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-artifactregistry_v1/google-apis-artifactregistry_v1.gemspec b/generated/google-apis-artifactregistry_v1/google-apis-artifactregistry_v1.gemspec index ceef3ddce..ea3eac68c 100644 --- a/generated/google-apis-artifactregistry_v1/google-apis-artifactregistry_v1.gemspec +++ b/generated/google-apis-artifactregistry_v1/google-apis-artifactregistry_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ArtifactregistryV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Artifact Registry API V1" + gem.summary = "Simple REST client for Artifact Registry API V1" gem.description = - "This is the legacy REST client for Artifact Registry API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Artifact Registry API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-artifactregistry_v1/lib/google/apis/artifactregistry_v1/gem_version.rb b/generated/google-apis-artifactregistry_v1/lib/google/apis/artifactregistry_v1/gem_version.rb index 6110722a0..f070cfc8c 100644 --- a/generated/google-apis-artifactregistry_v1/lib/google/apis/artifactregistry_v1/gem_version.rb +++ b/generated/google-apis-artifactregistry_v1/lib/google/apis/artifactregistry_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201215" diff --git a/generated/google-apis-artifactregistry_v1beta1/CHANGELOG.md b/generated/google-apis-artifactregistry_v1beta1/CHANGELOG.md index 1c4843082..ae2ad7cbb 100644 --- a/generated/google-apis-artifactregistry_v1beta1/CHANGELOG.md +++ b/generated/google-apis-artifactregistry_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-artifactregistry_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201215 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-artifactregistry_v1beta1/OVERVIEW.md b/generated/google-apis-artifactregistry_v1beta1/OVERVIEW.md index 18f9f8582..c914db641 100644 --- a/generated/google-apis-artifactregistry_v1beta1/OVERVIEW.md +++ b/generated/google-apis-artifactregistry_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Artifact Registry API +# Simple REST client for version V1beta1 of the Artifact Registry API This is a simple client library for version V1beta1 of the Artifact Registry API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Artifact Registry API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Artifactregistry service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Artifactregistry service in particular.) For reference information on specific calls in the Artifact Registry API, see the {Google::Apis::ArtifactregistryV1beta1::ArtifactRegistryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-artifactregistry_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-artifactregistry_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/artifacts/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-artifactregistry_v1beta1/google-apis-artifactregistry_v1beta1.gemspec b/generated/google-apis-artifactregistry_v1beta1/google-apis-artifactregistry_v1beta1.gemspec index b2c2d851f..3405be381 100644 --- a/generated/google-apis-artifactregistry_v1beta1/google-apis-artifactregistry_v1beta1.gemspec +++ b/generated/google-apis-artifactregistry_v1beta1/google-apis-artifactregistry_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ArtifactregistryV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Artifact Registry API V1beta1" + gem.summary = "Simple REST client for Artifact Registry API V1beta1" gem.description = - "This is the legacy REST client for Artifact Registry API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Artifact Registry API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-artifactregistry_v1beta1/lib/google/apis/artifactregistry_v1beta1/gem_version.rb b/generated/google-apis-artifactregistry_v1beta1/lib/google/apis/artifactregistry_v1beta1/gem_version.rb index 9fb6db604..61225ed1a 100644 --- a/generated/google-apis-artifactregistry_v1beta1/lib/google/apis/artifactregistry_v1beta1/gem_version.rb +++ b/generated/google-apis-artifactregistry_v1beta1/lib/google/apis/artifactregistry_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201215" diff --git a/generated/google-apis-artifactregistry_v1beta2/CHANGELOG.md b/generated/google-apis-artifactregistry_v1beta2/CHANGELOG.md index e6f1847b2..da05df82e 100644 --- a/generated/google-apis-artifactregistry_v1beta2/CHANGELOG.md +++ b/generated/google-apis-artifactregistry_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-artifactregistry_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201215 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-artifactregistry_v1beta2/OVERVIEW.md b/generated/google-apis-artifactregistry_v1beta2/OVERVIEW.md index 183b5eaeb..4b9b5ed8b 100644 --- a/generated/google-apis-artifactregistry_v1beta2/OVERVIEW.md +++ b/generated/google-apis-artifactregistry_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Artifact Registry API +# Simple REST client for version V1beta2 of the Artifact Registry API This is a simple client library for version V1beta2 of the Artifact Registry API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Artifact Registry API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Artifactregistry service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Artifactregistry service in particular.) For reference information on specific calls in the Artifact Registry API, see the {Google::Apis::ArtifactregistryV1beta2::ArtifactRegistryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-artifactregistry_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-artifactregistry_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/artifacts/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-artifactregistry_v1beta2/google-apis-artifactregistry_v1beta2.gemspec b/generated/google-apis-artifactregistry_v1beta2/google-apis-artifactregistry_v1beta2.gemspec index 0fd4eedce..f349ee9f9 100644 --- a/generated/google-apis-artifactregistry_v1beta2/google-apis-artifactregistry_v1beta2.gemspec +++ b/generated/google-apis-artifactregistry_v1beta2/google-apis-artifactregistry_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ArtifactregistryV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Artifact Registry API V1beta2" + gem.summary = "Simple REST client for Artifact Registry API V1beta2" gem.description = - "This is the legacy REST client for Artifact Registry API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Artifact Registry API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-artifactregistry_v1beta2/lib/google/apis/artifactregistry_v1beta2/gem_version.rb b/generated/google-apis-artifactregistry_v1beta2/lib/google/apis/artifactregistry_v1beta2/gem_version.rb index 8b7288585..f1eba8a2c 100644 --- a/generated/google-apis-artifactregistry_v1beta2/lib/google/apis/artifactregistry_v1beta2/gem_version.rb +++ b/generated/google-apis-artifactregistry_v1beta2/lib/google/apis/artifactregistry_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201215" diff --git a/generated/google-apis-assuredworkloads_v1/CHANGELOG.md b/generated/google-apis-assuredworkloads_v1/CHANGELOG.md index 01891d5b4..0def88acf 100644 --- a/generated/google-apis-assuredworkloads_v1/CHANGELOG.md +++ b/generated/google-apis-assuredworkloads_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-assuredworkloads_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-assuredworkloads_v1/OVERVIEW.md b/generated/google-apis-assuredworkloads_v1/OVERVIEW.md index 2edb63c0e..a39741abc 100644 --- a/generated/google-apis-assuredworkloads_v1/OVERVIEW.md +++ b/generated/google-apis-assuredworkloads_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Assured Workloads API +# Simple REST client for version V1 of the Assured Workloads API This is a simple client library for version V1 of the Assured Workloads API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Assured Workloads API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Assuredworkloads service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Assuredworkloads service in particular.) For reference information on specific calls in the Assured Workloads API, see the {Google::Apis::AssuredworkloadsV1::AssuredworkloadsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-assuredworkloads_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-assuredworkloads_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-assuredworkloads_v1/google-apis-assuredworkloads_v1.gemspec b/generated/google-apis-assuredworkloads_v1/google-apis-assuredworkloads_v1.gemspec index 680d4a3f9..8d2b7685f 100644 --- a/generated/google-apis-assuredworkloads_v1/google-apis-assuredworkloads_v1.gemspec +++ b/generated/google-apis-assuredworkloads_v1/google-apis-assuredworkloads_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::AssuredworkloadsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Assured Workloads API V1" + gem.summary = "Simple REST client for Assured Workloads API V1" gem.description = - "This is the legacy REST client for Assured Workloads API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Assured Workloads API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-assuredworkloads_v1/lib/google/apis/assuredworkloads_v1/gem_version.rb b/generated/google-apis-assuredworkloads_v1/lib/google/apis/assuredworkloads_v1/gem_version.rb index 808d976e9..d2ed593df 100644 --- a/generated/google-apis-assuredworkloads_v1/lib/google/apis/assuredworkloads_v1/gem_version.rb +++ b/generated/google-apis-assuredworkloads_v1/lib/google/apis/assuredworkloads_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-bigquery_v2/CHANGELOG.md b/generated/google-apis-bigquery_v2/CHANGELOG.md index 1048b4179..3f10ae14a 100644 --- a/generated/google-apis-bigquery_v2/CHANGELOG.md +++ b/generated/google-apis-bigquery_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigquery_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201030 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigquery_v2/OVERVIEW.md b/generated/google-apis-bigquery_v2/OVERVIEW.md index 199c6705c..6a5f585c5 100644 --- a/generated/google-apis-bigquery_v2/OVERVIEW.md +++ b/generated/google-apis-bigquery_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the BigQuery API +# Simple REST client for version V2 of the BigQuery API This is a simple client library for version V2 of the BigQuery API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the BigQuery API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigquery service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigquery service in particular.) For reference information on specific calls in the BigQuery API, see the {Google::Apis::BigqueryV2::BigqueryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigquery_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigquery_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigquery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigquery_v2/google-apis-bigquery_v2.gemspec b/generated/google-apis-bigquery_v2/google-apis-bigquery_v2.gemspec index 7c7d685b5..13068fb88 100644 --- a/generated/google-apis-bigquery_v2/google-apis-bigquery_v2.gemspec +++ b/generated/google-apis-bigquery_v2/google-apis-bigquery_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigqueryV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for BigQuery API V2" + gem.summary = "Simple REST client for BigQuery API V2" gem.description = - "This is the legacy REST client for BigQuery API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for BigQuery API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigquery_v2/lib/google/apis/bigquery_v2/gem_version.rb b/generated/google-apis-bigquery_v2/lib/google/apis/bigquery_v2/gem_version.rb index 156107e6d..bfd4437dd 100644 --- a/generated/google-apis-bigquery_v2/lib/google/apis/bigquery_v2/gem_version.rb +++ b/generated/google-apis-bigquery_v2/lib/google/apis/bigquery_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201030" diff --git a/generated/google-apis-bigqueryconnection_v1beta1/CHANGELOG.md b/generated/google-apis-bigqueryconnection_v1beta1/CHANGELOG.md index 03dbac2e9..47a81abdf 100644 --- a/generated/google-apis-bigqueryconnection_v1beta1/CHANGELOG.md +++ b/generated/google-apis-bigqueryconnection_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigqueryconnection_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201031 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigqueryconnection_v1beta1/OVERVIEW.md b/generated/google-apis-bigqueryconnection_v1beta1/OVERVIEW.md index 48fd035ac..3d7122baa 100644 --- a/generated/google-apis-bigqueryconnection_v1beta1/OVERVIEW.md +++ b/generated/google-apis-bigqueryconnection_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the BigQuery Connection API +# Simple REST client for version V1beta1 of the BigQuery Connection API This is a simple client library for version V1beta1 of the BigQuery Connection API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the BigQuery Connection A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigqueryconnection service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigqueryconnection service in particular.) For reference information on specific calls in the BigQuery Connection API, see the {Google::Apis::BigqueryconnectionV1beta1::BigQueryConnectionServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigqueryconnection_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigqueryconnection_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigquery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigqueryconnection_v1beta1/google-apis-bigqueryconnection_v1beta1.gemspec b/generated/google-apis-bigqueryconnection_v1beta1/google-apis-bigqueryconnection_v1beta1.gemspec index a2031c11c..4231b33c7 100644 --- a/generated/google-apis-bigqueryconnection_v1beta1/google-apis-bigqueryconnection_v1beta1.gemspec +++ b/generated/google-apis-bigqueryconnection_v1beta1/google-apis-bigqueryconnection_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigqueryconnectionV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for BigQuery Connection API V1beta1" + gem.summary = "Simple REST client for BigQuery Connection API V1beta1" gem.description = - "This is the legacy REST client for BigQuery Connection API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for BigQuery Connection API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigqueryconnection_v1beta1/lib/google/apis/bigqueryconnection_v1beta1/gem_version.rb b/generated/google-apis-bigqueryconnection_v1beta1/lib/google/apis/bigqueryconnection_v1beta1/gem_version.rb index 5c3a15cbc..080ee9db0 100644 --- a/generated/google-apis-bigqueryconnection_v1beta1/lib/google/apis/bigqueryconnection_v1beta1/gem_version.rb +++ b/generated/google-apis-bigqueryconnection_v1beta1/lib/google/apis/bigqueryconnection_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201031" diff --git a/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md b/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md index 9c75a571f..7f9a9309b 100644 --- a/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md +++ b/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigquerydatatransfer_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigquerydatatransfer_v1/OVERVIEW.md b/generated/google-apis-bigquerydatatransfer_v1/OVERVIEW.md index 3b71c81d9..0f139d166 100644 --- a/generated/google-apis-bigquerydatatransfer_v1/OVERVIEW.md +++ b/generated/google-apis-bigquerydatatransfer_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the BigQuery Data Transfer API +# Simple REST client for version V1 of the BigQuery Data Transfer API This is a simple client library for version V1 of the BigQuery Data Transfer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the BigQuery Data Transfer API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigquerydatatransfer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigquerydatatransfer service in particular.) For reference information on specific calls in the BigQuery Data Transfer API, see the {Google::Apis::BigquerydatatransferV1::BigQueryDataTransferService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigquerydatatransfer_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigquerydatatransfer_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigquery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigquerydatatransfer_v1/google-apis-bigquerydatatransfer_v1.gemspec b/generated/google-apis-bigquerydatatransfer_v1/google-apis-bigquerydatatransfer_v1.gemspec index 6c51e450c..bd99e4775 100644 --- a/generated/google-apis-bigquerydatatransfer_v1/google-apis-bigquerydatatransfer_v1.gemspec +++ b/generated/google-apis-bigquerydatatransfer_v1/google-apis-bigquerydatatransfer_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigquerydatatransferV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for BigQuery Data Transfer API V1" + gem.summary = "Simple REST client for BigQuery Data Transfer API V1" gem.description = - "This is the legacy REST client for BigQuery Data Transfer API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for BigQuery Data Transfer API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigquerydatatransfer_v1/lib/google/apis/bigquerydatatransfer_v1/gem_version.rb b/generated/google-apis-bigquerydatatransfer_v1/lib/google/apis/bigquerydatatransfer_v1/gem_version.rb index 815fecfb9..af229add3 100644 --- a/generated/google-apis-bigquerydatatransfer_v1/lib/google/apis/bigquerydatatransfer_v1/gem_version.rb +++ b/generated/google-apis-bigquerydatatransfer_v1/lib/google/apis/bigquerydatatransfer_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-bigqueryreservation_v1/CHANGELOG.md b/generated/google-apis-bigqueryreservation_v1/CHANGELOG.md index 71312322f..c27d6b3a0 100644 --- a/generated/google-apis-bigqueryreservation_v1/CHANGELOG.md +++ b/generated/google-apis-bigqueryreservation_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigqueryreservation_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200808 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigqueryreservation_v1/OVERVIEW.md b/generated/google-apis-bigqueryreservation_v1/OVERVIEW.md index 3f42b7706..7061f2eaf 100644 --- a/generated/google-apis-bigqueryreservation_v1/OVERVIEW.md +++ b/generated/google-apis-bigqueryreservation_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the BigQuery Reservation API +# Simple REST client for version V1 of the BigQuery Reservation API This is a simple client library for version V1 of the BigQuery Reservation API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the BigQuery Reservation API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigqueryreservation service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigqueryreservation service in particular.) For reference information on specific calls in the BigQuery Reservation API, see the {Google::Apis::BigqueryreservationV1::BigQueryReservationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigqueryreservation_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigqueryreservation_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigquery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigqueryreservation_v1/google-apis-bigqueryreservation_v1.gemspec b/generated/google-apis-bigqueryreservation_v1/google-apis-bigqueryreservation_v1.gemspec index befea0490..c86c4e7e2 100644 --- a/generated/google-apis-bigqueryreservation_v1/google-apis-bigqueryreservation_v1.gemspec +++ b/generated/google-apis-bigqueryreservation_v1/google-apis-bigqueryreservation_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigqueryreservationV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for BigQuery Reservation API V1" + gem.summary = "Simple REST client for BigQuery Reservation API V1" gem.description = - "This is the legacy REST client for BigQuery Reservation API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for BigQuery Reservation API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigqueryreservation_v1/lib/google/apis/bigqueryreservation_v1/gem_version.rb b/generated/google-apis-bigqueryreservation_v1/lib/google/apis/bigqueryreservation_v1/gem_version.rb index bb929c5da..56ce67e23 100644 --- a/generated/google-apis-bigqueryreservation_v1/lib/google/apis/bigqueryreservation_v1/gem_version.rb +++ b/generated/google-apis-bigqueryreservation_v1/lib/google/apis/bigqueryreservation_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200808" diff --git a/generated/google-apis-bigqueryreservation_v1beta1/CHANGELOG.md b/generated/google-apis-bigqueryreservation_v1beta1/CHANGELOG.md index 322b9ae46..0977350c7 100644 --- a/generated/google-apis-bigqueryreservation_v1beta1/CHANGELOG.md +++ b/generated/google-apis-bigqueryreservation_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigqueryreservation_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200808 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigqueryreservation_v1beta1/OVERVIEW.md b/generated/google-apis-bigqueryreservation_v1beta1/OVERVIEW.md index 94af35731..c84567a80 100644 --- a/generated/google-apis-bigqueryreservation_v1beta1/OVERVIEW.md +++ b/generated/google-apis-bigqueryreservation_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the BigQuery Reservation API +# Simple REST client for version V1beta1 of the BigQuery Reservation API This is a simple client library for version V1beta1 of the BigQuery Reservation API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the BigQuery Reservation * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigqueryreservation service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigqueryreservation service in particular.) For reference information on specific calls in the BigQuery Reservation API, see the {Google::Apis::BigqueryreservationV1beta1::BigQueryReservationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigqueryreservation_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigqueryreservation_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigquery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigqueryreservation_v1beta1/google-apis-bigqueryreservation_v1beta1.gemspec b/generated/google-apis-bigqueryreservation_v1beta1/google-apis-bigqueryreservation_v1beta1.gemspec index a3127f5ac..bb83bd057 100644 --- a/generated/google-apis-bigqueryreservation_v1beta1/google-apis-bigqueryreservation_v1beta1.gemspec +++ b/generated/google-apis-bigqueryreservation_v1beta1/google-apis-bigqueryreservation_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigqueryreservationV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for BigQuery Reservation API V1beta1" + gem.summary = "Simple REST client for BigQuery Reservation API V1beta1" gem.description = - "This is the legacy REST client for BigQuery Reservation API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for BigQuery Reservation API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigqueryreservation_v1beta1/lib/google/apis/bigqueryreservation_v1beta1/gem_version.rb b/generated/google-apis-bigqueryreservation_v1beta1/lib/google/apis/bigqueryreservation_v1beta1/gem_version.rb index bfdf4d34a..175390969 100644 --- a/generated/google-apis-bigqueryreservation_v1beta1/lib/google/apis/bigqueryreservation_v1beta1/gem_version.rb +++ b/generated/google-apis-bigqueryreservation_v1beta1/lib/google/apis/bigqueryreservation_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200808" diff --git a/generated/google-apis-bigtableadmin_v1/CHANGELOG.md b/generated/google-apis-bigtableadmin_v1/CHANGELOG.md index 86bb3d1f3..9186cafcc 100644 --- a/generated/google-apis-bigtableadmin_v1/CHANGELOG.md +++ b/generated/google-apis-bigtableadmin_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigtableadmin_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200821 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigtableadmin_v1/OVERVIEW.md b/generated/google-apis-bigtableadmin_v1/OVERVIEW.md index 19a734b49..38d06f110 100644 --- a/generated/google-apis-bigtableadmin_v1/OVERVIEW.md +++ b/generated/google-apis-bigtableadmin_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Bigtable Admin API +# Simple REST client for version V1 of the Cloud Bigtable Admin API This is a simple client library for version V1 of the Cloud Bigtable Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Bigtable Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigtableadmin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigtableadmin service in particular.) For reference information on specific calls in the Cloud Bigtable Admin API, see the {Google::Apis::BigtableadminV1::BigtableAdminService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigtableadmin_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigtableadmin_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigtable/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigtableadmin_v1/google-apis-bigtableadmin_v1.gemspec b/generated/google-apis-bigtableadmin_v1/google-apis-bigtableadmin_v1.gemspec index d4dac9479..cd2fe8949 100644 --- a/generated/google-apis-bigtableadmin_v1/google-apis-bigtableadmin_v1.gemspec +++ b/generated/google-apis-bigtableadmin_v1/google-apis-bigtableadmin_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigtableadminV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Bigtable Admin API V1" + gem.summary = "Simple REST client for Cloud Bigtable Admin API V1" gem.description = - "This is the legacy REST client for Cloud Bigtable Admin API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Bigtable Admin API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigtableadmin_v1/lib/google/apis/bigtableadmin_v1/gem_version.rb b/generated/google-apis-bigtableadmin_v1/lib/google/apis/bigtableadmin_v1/gem_version.rb index 4797518b1..3d4a82e6e 100644 --- a/generated/google-apis-bigtableadmin_v1/lib/google/apis/bigtableadmin_v1/gem_version.rb +++ b/generated/google-apis-bigtableadmin_v1/lib/google/apis/bigtableadmin_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200821" diff --git a/generated/google-apis-bigtableadmin_v2/CHANGELOG.md b/generated/google-apis-bigtableadmin_v2/CHANGELOG.md index 987d2f2b9..d3e37e3e7 100644 --- a/generated/google-apis-bigtableadmin_v2/CHANGELOG.md +++ b/generated/google-apis-bigtableadmin_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-bigtableadmin_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200821 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-bigtableadmin_v2/OVERVIEW.md b/generated/google-apis-bigtableadmin_v2/OVERVIEW.md index fd4f9017e..81ce87188 100644 --- a/generated/google-apis-bigtableadmin_v2/OVERVIEW.md +++ b/generated/google-apis-bigtableadmin_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Bigtable Admin API +# Simple REST client for version V2 of the Cloud Bigtable Admin API This is a simple client library for version V2 of the Cloud Bigtable Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Bigtable Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Bigtableadmin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigtableadmin service in particular.) For reference information on specific calls in the Cloud Bigtable Admin API, see the {Google::Apis::BigtableadminV2::BigtableAdminService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-bigtableadmin_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-bigtableadmin_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/bigtable/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-bigtableadmin_v2/google-apis-bigtableadmin_v2.gemspec b/generated/google-apis-bigtableadmin_v2/google-apis-bigtableadmin_v2.gemspec index f4901fd8e..7c9a96b0e 100644 --- a/generated/google-apis-bigtableadmin_v2/google-apis-bigtableadmin_v2.gemspec +++ b/generated/google-apis-bigtableadmin_v2/google-apis-bigtableadmin_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BigtableadminV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Bigtable Admin API V2" + gem.summary = "Simple REST client for Cloud Bigtable Admin API V2" gem.description = - "This is the legacy REST client for Cloud Bigtable Admin API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Bigtable Admin API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-bigtableadmin_v2/lib/google/apis/bigtableadmin_v2/gem_version.rb b/generated/google-apis-bigtableadmin_v2/lib/google/apis/bigtableadmin_v2/gem_version.rb index bb72be1dc..0fc95d7c4 100644 --- a/generated/google-apis-bigtableadmin_v2/lib/google/apis/bigtableadmin_v2/gem_version.rb +++ b/generated/google-apis-bigtableadmin_v2/lib/google/apis/bigtableadmin_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200821" diff --git a/generated/google-apis-billingbudgets_v1/CHANGELOG.md b/generated/google-apis-billingbudgets_v1/CHANGELOG.md index dc8d37314..f5398157a 100644 --- a/generated/google-apis-billingbudgets_v1/CHANGELOG.md +++ b/generated/google-apis-billingbudgets_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-billingbudgets_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201107 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-billingbudgets_v1/OVERVIEW.md b/generated/google-apis-billingbudgets_v1/OVERVIEW.md index 5fbf15120..38fe98c0b 100644 --- a/generated/google-apis-billingbudgets_v1/OVERVIEW.md +++ b/generated/google-apis-billingbudgets_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Billing Budget API +# Simple REST client for version V1 of the Cloud Billing Budget API This is a simple client library for version V1 of the Cloud Billing Budget API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Billing Budget API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Billingbudgets service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Billingbudgets service in particular.) For reference information on specific calls in the Cloud Billing Budget API, see the {Google::Apis::BillingbudgetsV1::CloudBillingBudgetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-billingbudgets_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-billingbudgets_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/billing/docs/how-to/budget-api-overview) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-billingbudgets_v1/google-apis-billingbudgets_v1.gemspec b/generated/google-apis-billingbudgets_v1/google-apis-billingbudgets_v1.gemspec index 0d2fbfce0..e7e221e06 100644 --- a/generated/google-apis-billingbudgets_v1/google-apis-billingbudgets_v1.gemspec +++ b/generated/google-apis-billingbudgets_v1/google-apis-billingbudgets_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BillingbudgetsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Billing Budget API V1" + gem.summary = "Simple REST client for Cloud Billing Budget API V1" gem.description = - "This is the legacy REST client for Cloud Billing Budget API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Billing Budget API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-billingbudgets_v1/lib/google/apis/billingbudgets_v1/gem_version.rb b/generated/google-apis-billingbudgets_v1/lib/google/apis/billingbudgets_v1/gem_version.rb index 36dea822a..eb9e2e4a4 100644 --- a/generated/google-apis-billingbudgets_v1/lib/google/apis/billingbudgets_v1/gem_version.rb +++ b/generated/google-apis-billingbudgets_v1/lib/google/apis/billingbudgets_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201107" diff --git a/generated/google-apis-billingbudgets_v1beta1/CHANGELOG.md b/generated/google-apis-billingbudgets_v1beta1/CHANGELOG.md index 83432057a..ef46fe322 100644 --- a/generated/google-apis-billingbudgets_v1beta1/CHANGELOG.md +++ b/generated/google-apis-billingbudgets_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-billingbudgets_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201107 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-billingbudgets_v1beta1/OVERVIEW.md b/generated/google-apis-billingbudgets_v1beta1/OVERVIEW.md index a00ed3e6a..7add5a770 100644 --- a/generated/google-apis-billingbudgets_v1beta1/OVERVIEW.md +++ b/generated/google-apis-billingbudgets_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Billing Budget API +# Simple REST client for version V1beta1 of the Cloud Billing Budget API This is a simple client library for version V1beta1 of the Cloud Billing Budget API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Billing Budget * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Billingbudgets service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Billingbudgets service in particular.) For reference information on specific calls in the Cloud Billing Budget API, see the {Google::Apis::BillingbudgetsV1beta1::CloudBillingBudgetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-billingbudgets_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-billingbudgets_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/billing/docs/how-to/budget-api-overview) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-billingbudgets_v1beta1/google-apis-billingbudgets_v1beta1.gemspec b/generated/google-apis-billingbudgets_v1beta1/google-apis-billingbudgets_v1beta1.gemspec index d41b4f46b..600dad111 100644 --- a/generated/google-apis-billingbudgets_v1beta1/google-apis-billingbudgets_v1beta1.gemspec +++ b/generated/google-apis-billingbudgets_v1beta1/google-apis-billingbudgets_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BillingbudgetsV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Billing Budget API V1beta1" + gem.summary = "Simple REST client for Cloud Billing Budget API V1beta1" gem.description = - "This is the legacy REST client for Cloud Billing Budget API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Billing Budget API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-billingbudgets_v1beta1/lib/google/apis/billingbudgets_v1beta1/gem_version.rb b/generated/google-apis-billingbudgets_v1beta1/lib/google/apis/billingbudgets_v1beta1/gem_version.rb index 6e65e4689..8ae98b3ac 100644 --- a/generated/google-apis-billingbudgets_v1beta1/lib/google/apis/billingbudgets_v1beta1/gem_version.rb +++ b/generated/google-apis-billingbudgets_v1beta1/lib/google/apis/billingbudgets_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201107" diff --git a/generated/google-apis-binaryauthorization_v1/CHANGELOG.md b/generated/google-apis-binaryauthorization_v1/CHANGELOG.md index 32ff36801..cb905c854 100644 --- a/generated/google-apis-binaryauthorization_v1/CHANGELOG.md +++ b/generated/google-apis-binaryauthorization_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-binaryauthorization_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-binaryauthorization_v1/OVERVIEW.md b/generated/google-apis-binaryauthorization_v1/OVERVIEW.md index 2ceffc12a..d8a7ea392 100644 --- a/generated/google-apis-binaryauthorization_v1/OVERVIEW.md +++ b/generated/google-apis-binaryauthorization_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Binary Authorization API +# Simple REST client for version V1 of the Binary Authorization API This is a simple client library for version V1 of the Binary Authorization API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Binary Authorization API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Binaryauthorization service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Binaryauthorization service in particular.) For reference information on specific calls in the Binary Authorization API, see the {Google::Apis::BinaryauthorizationV1::BinaryAuthorizationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-binaryauthorization_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-binaryauthorization_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/binary-authorization/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-binaryauthorization_v1/google-apis-binaryauthorization_v1.gemspec b/generated/google-apis-binaryauthorization_v1/google-apis-binaryauthorization_v1.gemspec index a527a0bf9..b1579e2a8 100644 --- a/generated/google-apis-binaryauthorization_v1/google-apis-binaryauthorization_v1.gemspec +++ b/generated/google-apis-binaryauthorization_v1/google-apis-binaryauthorization_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BinaryauthorizationV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Binary Authorization API V1" + gem.summary = "Simple REST client for Binary Authorization API V1" gem.description = - "This is the legacy REST client for Binary Authorization API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Binary Authorization API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-binaryauthorization_v1/lib/google/apis/binaryauthorization_v1/gem_version.rb b/generated/google-apis-binaryauthorization_v1/lib/google/apis/binaryauthorization_v1/gem_version.rb index c38cad2a0..60269a25f 100644 --- a/generated/google-apis-binaryauthorization_v1/lib/google/apis/binaryauthorization_v1/gem_version.rb +++ b/generated/google-apis-binaryauthorization_v1/lib/google/apis/binaryauthorization_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-binaryauthorization_v1beta1/CHANGELOG.md b/generated/google-apis-binaryauthorization_v1beta1/CHANGELOG.md index 4f4c23565..ba741c5b5 100644 --- a/generated/google-apis-binaryauthorization_v1beta1/CHANGELOG.md +++ b/generated/google-apis-binaryauthorization_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-binaryauthorization_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-binaryauthorization_v1beta1/OVERVIEW.md b/generated/google-apis-binaryauthorization_v1beta1/OVERVIEW.md index e50f652dd..e834a9efb 100644 --- a/generated/google-apis-binaryauthorization_v1beta1/OVERVIEW.md +++ b/generated/google-apis-binaryauthorization_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Binary Authorization API +# Simple REST client for version V1beta1 of the Binary Authorization API This is a simple client library for version V1beta1 of the Binary Authorization API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Binary Authorization * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Binaryauthorization service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Binaryauthorization service in particular.) For reference information on specific calls in the Binary Authorization API, see the {Google::Apis::BinaryauthorizationV1beta1::BinaryAuthorizationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-binaryauthorization_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-binaryauthorization_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/binary-authorization/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-binaryauthorization_v1beta1/google-apis-binaryauthorization_v1beta1.gemspec b/generated/google-apis-binaryauthorization_v1beta1/google-apis-binaryauthorization_v1beta1.gemspec index d3f30d867..e930aeb5a 100644 --- a/generated/google-apis-binaryauthorization_v1beta1/google-apis-binaryauthorization_v1beta1.gemspec +++ b/generated/google-apis-binaryauthorization_v1beta1/google-apis-binaryauthorization_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BinaryauthorizationV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Binary Authorization API V1beta1" + gem.summary = "Simple REST client for Binary Authorization API V1beta1" gem.description = - "This is the legacy REST client for Binary Authorization API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Binary Authorization API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-binaryauthorization_v1beta1/lib/google/apis/binaryauthorization_v1beta1/gem_version.rb b/generated/google-apis-binaryauthorization_v1beta1/lib/google/apis/binaryauthorization_v1beta1/gem_version.rb index 3c68b5e45..140f39748 100644 --- a/generated/google-apis-binaryauthorization_v1beta1/lib/google/apis/binaryauthorization_v1beta1/gem_version.rb +++ b/generated/google-apis-binaryauthorization_v1beta1/lib/google/apis/binaryauthorization_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-blogger_v2/CHANGELOG.md b/generated/google-apis-blogger_v2/CHANGELOG.md index e92153543..a83ab64ab 100644 --- a/generated/google-apis-blogger_v2/CHANGELOG.md +++ b/generated/google-apis-blogger_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-blogger_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-blogger_v2/OVERVIEW.md b/generated/google-apis-blogger_v2/OVERVIEW.md index 8c67e86af..973314191 100644 --- a/generated/google-apis-blogger_v2/OVERVIEW.md +++ b/generated/google-apis-blogger_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Blogger API v3 +# Simple REST client for version V2 of the Blogger API v3 This is a simple client library for version V2 of the Blogger API v3. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Blogger API v3. It provide * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Blogger service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Blogger service in particular.) For reference information on specific calls in the Blogger API v3, see the {Google::Apis::BloggerV2::BloggerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-blogger_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-blogger_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/blogger/docs/3.0/getting_started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-blogger_v2/google-apis-blogger_v2.gemspec b/generated/google-apis-blogger_v2/google-apis-blogger_v2.gemspec index 2602d8060..c6142d033 100644 --- a/generated/google-apis-blogger_v2/google-apis-blogger_v2.gemspec +++ b/generated/google-apis-blogger_v2/google-apis-blogger_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BloggerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Blogger API v3 V2" + gem.summary = "Simple REST client for Blogger API v3 V2" gem.description = - "This is the legacy REST client for Blogger API v3 V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Blogger API v3 V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-blogger_v2/lib/google/apis/blogger_v2/gem_version.rb b/generated/google-apis-blogger_v2/lib/google/apis/blogger_v2/gem_version.rb index 8e9e5ee9e..cdc94116b 100644 --- a/generated/google-apis-blogger_v2/lib/google/apis/blogger_v2/gem_version.rb +++ b/generated/google-apis-blogger_v2/lib/google/apis/blogger_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-blogger_v3/CHANGELOG.md b/generated/google-apis-blogger_v3/CHANGELOG.md index 20f1cd9d9..e168c7e74 100644 --- a/generated/google-apis-blogger_v3/CHANGELOG.md +++ b/generated/google-apis-blogger_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-blogger_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-blogger_v3/OVERVIEW.md b/generated/google-apis-blogger_v3/OVERVIEW.md index 2334a2bd1..c9643c3e3 100644 --- a/generated/google-apis-blogger_v3/OVERVIEW.md +++ b/generated/google-apis-blogger_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Blogger API v3 +# Simple REST client for version V3 of the Blogger API v3 This is a simple client library for version V3 of the Blogger API v3. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Blogger API v3. It provide * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Blogger service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Blogger service in particular.) For reference information on specific calls in the Blogger API v3, see the {Google::Apis::BloggerV3::BloggerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-blogger_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-blogger_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/blogger/docs/3.0/getting_started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-blogger_v3/google-apis-blogger_v3.gemspec b/generated/google-apis-blogger_v3/google-apis-blogger_v3.gemspec index 87c400366..9c0de47ac 100644 --- a/generated/google-apis-blogger_v3/google-apis-blogger_v3.gemspec +++ b/generated/google-apis-blogger_v3/google-apis-blogger_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BloggerV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Blogger API v3 V3" + gem.summary = "Simple REST client for Blogger API v3 V3" gem.description = - "This is the legacy REST client for Blogger API v3 V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Blogger API v3 V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-blogger_v3/lib/google/apis/blogger_v3/gem_version.rb b/generated/google-apis-blogger_v3/lib/google/apis/blogger_v3/gem_version.rb index bd5c1ed27..6d222332d 100644 --- a/generated/google-apis-blogger_v3/lib/google/apis/blogger_v3/gem_version.rb +++ b/generated/google-apis-blogger_v3/lib/google/apis/blogger_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-books_v1/CHANGELOG.md b/generated/google-apis-books_v1/CHANGELOG.md index 7566dfcf7..cb572a1d4 100644 --- a/generated/google-apis-books_v1/CHANGELOG.md +++ b/generated/google-apis-books_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-books_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201021 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-books_v1/OVERVIEW.md b/generated/google-apis-books_v1/OVERVIEW.md index 842ae9d61..45c4a2783 100644 --- a/generated/google-apis-books_v1/OVERVIEW.md +++ b/generated/google-apis-books_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Books API +# Simple REST client for version V1 of the Books API This is a simple client library for version V1 of the Books API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Books API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Books service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Books service in particular.) For reference information on specific calls in the Books API, see the {Google::Apis::BooksV1::BooksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-books_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-books_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://code.google.com/apis/books/docs/v1/getting_started.html) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-books_v1/google-apis-books_v1.gemspec b/generated/google-apis-books_v1/google-apis-books_v1.gemspec index 9530d5edb..0beb15472 100644 --- a/generated/google-apis-books_v1/google-apis-books_v1.gemspec +++ b/generated/google-apis-books_v1/google-apis-books_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::BooksV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Books API V1" + gem.summary = "Simple REST client for Books API V1" gem.description = - "This is the legacy REST client for Books API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Books API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-books_v1/lib/google/apis/books_v1/gem_version.rb b/generated/google-apis-books_v1/lib/google/apis/books_v1/gem_version.rb index 956ff7712..1e0409309 100644 --- a/generated/google-apis-books_v1/lib/google/apis/books_v1/gem_version.rb +++ b/generated/google-apis-books_v1/lib/google/apis/books_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201021" diff --git a/generated/google-apis-calendar_v3/CHANGELOG.md b/generated/google-apis-calendar_v3/CHANGELOG.md index 0abbd2ade..f13ff8f55 100644 --- a/generated/google-apis-calendar_v3/CHANGELOG.md +++ b/generated/google-apis-calendar_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-calendar_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201028 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-calendar_v3/OVERVIEW.md b/generated/google-apis-calendar_v3/OVERVIEW.md index 4cce536a1..821b37325 100644 --- a/generated/google-apis-calendar_v3/OVERVIEW.md +++ b/generated/google-apis-calendar_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Calendar API +# Simple REST client for version V3 of the Calendar API This is a simple client library for version V3 of the Calendar API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Calendar API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Calendar service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Calendar service in particular.) For reference information on specific calls in the Calendar API, see the {Google::Apis::CalendarV3::CalendarService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-calendar_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-calendar_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/google-apps/calendar/firstapp) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-calendar_v3/google-apis-calendar_v3.gemspec b/generated/google-apis-calendar_v3/google-apis-calendar_v3.gemspec index b465c9384..bda6f8fe3 100644 --- a/generated/google-apis-calendar_v3/google-apis-calendar_v3.gemspec +++ b/generated/google-apis-calendar_v3/google-apis-calendar_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CalendarV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Calendar API V3" + gem.summary = "Simple REST client for Calendar API V3" gem.description = - "This is the legacy REST client for Calendar API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Calendar API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-calendar_v3/lib/google/apis/calendar_v3/gem_version.rb b/generated/google-apis-calendar_v3/lib/google/apis/calendar_v3/gem_version.rb index ca4e67a55..67a7b4251 100644 --- a/generated/google-apis-calendar_v3/lib/google/apis/calendar_v3/gem_version.rb +++ b/generated/google-apis-calendar_v3/lib/google/apis/calendar_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201028" diff --git a/generated/google-apis-chat_v1/CHANGELOG.md b/generated/google-apis-chat_v1/CHANGELOG.md index c29de7797..2f2f3fa6e 100644 --- a/generated/google-apis-chat_v1/CHANGELOG.md +++ b/generated/google-apis-chat_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-chat_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-chat_v1/OVERVIEW.md b/generated/google-apis-chat_v1/OVERVIEW.md index bdaa16db3..de40c7d33 100644 --- a/generated/google-apis-chat_v1/OVERVIEW.md +++ b/generated/google-apis-chat_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Hangouts Chat API +# Simple REST client for version V1 of the Hangouts Chat API This is a simple client library for version V1 of the Hangouts Chat API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Hangouts Chat API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Chat service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Chat service in particular.) For reference information on specific calls in the Hangouts Chat API, see the {Google::Apis::ChatV1::HangoutsChatService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-chat_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-chat_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/hangouts/chat) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-chat_v1/google-apis-chat_v1.gemspec b/generated/google-apis-chat_v1/google-apis-chat_v1.gemspec index 656b3bba4..c40d9926a 100644 --- a/generated/google-apis-chat_v1/google-apis-chat_v1.gemspec +++ b/generated/google-apis-chat_v1/google-apis-chat_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ChatV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Hangouts Chat API V1" + gem.summary = "Simple REST client for Hangouts Chat API V1" gem.description = - "This is the legacy REST client for Hangouts Chat API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Hangouts Chat API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-chat_v1/lib/google/apis/chat_v1/gem_version.rb b/generated/google-apis-chat_v1/lib/google/apis/chat_v1/gem_version.rb index 24a690ab7..594e782c5 100644 --- a/generated/google-apis-chat_v1/lib/google/apis/chat_v1/gem_version.rb +++ b/generated/google-apis-chat_v1/lib/google/apis/chat_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-chromeuxreport_v1/CHANGELOG.md b/generated/google-apis-chromeuxreport_v1/CHANGELOG.md index 27653c527..baec8c9df 100644 --- a/generated/google-apis-chromeuxreport_v1/CHANGELOG.md +++ b/generated/google-apis-chromeuxreport_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-chromeuxreport_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-chromeuxreport_v1/OVERVIEW.md b/generated/google-apis-chromeuxreport_v1/OVERVIEW.md index 9ff447cd0..65f280864 100644 --- a/generated/google-apis-chromeuxreport_v1/OVERVIEW.md +++ b/generated/google-apis-chromeuxreport_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Chrome UX Report API +# Simple REST client for version V1 of the Chrome UX Report API This is a simple client library for version V1 of the Chrome UX Report API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Chrome UX Report API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Chromeuxreport service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Chromeuxreport service in particular.) For reference information on specific calls in the Chrome UX Report API, see the {Google::Apis::ChromeuxreportV1::ChromeUXReportService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-chromeuxreport_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-chromeuxreport_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/web/tools/chrome-user-experience-report/api/reference) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-chromeuxreport_v1/google-apis-chromeuxreport_v1.gemspec b/generated/google-apis-chromeuxreport_v1/google-apis-chromeuxreport_v1.gemspec index e970ad63f..7249f0e79 100644 --- a/generated/google-apis-chromeuxreport_v1/google-apis-chromeuxreport_v1.gemspec +++ b/generated/google-apis-chromeuxreport_v1/google-apis-chromeuxreport_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ChromeuxreportV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Chrome UX Report API V1" + gem.summary = "Simple REST client for Chrome UX Report API V1" gem.description = - "This is the legacy REST client for Chrome UX Report API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Chrome UX Report API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-chromeuxreport_v1/lib/google/apis/chromeuxreport_v1/gem_version.rb b/generated/google-apis-chromeuxreport_v1/lib/google/apis/chromeuxreport_v1/gem_version.rb index 54eac0a28..10660eb53 100644 --- a/generated/google-apis-chromeuxreport_v1/lib/google/apis/chromeuxreport_v1/gem_version.rb +++ b/generated/google-apis-chromeuxreport_v1/lib/google/apis/chromeuxreport_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-civicinfo_v2/CHANGELOG.md b/generated/google-apis-civicinfo_v2/CHANGELOG.md index ad5681be8..f304a05ae 100644 --- a/generated/google-apis-civicinfo_v2/CHANGELOG.md +++ b/generated/google-apis-civicinfo_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-civicinfo_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201012 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-civicinfo_v2/OVERVIEW.md b/generated/google-apis-civicinfo_v2/OVERVIEW.md index 1204f971d..54b35b679 100644 --- a/generated/google-apis-civicinfo_v2/OVERVIEW.md +++ b/generated/google-apis-civicinfo_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Google Civic Information API +# Simple REST client for version V2 of the Google Civic Information API This is a simple client library for version V2 of the Google Civic Information API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Google Civic Information A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Civicinfo service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Civicinfo service in particular.) For reference information on specific calls in the Google Civic Information API, see the {Google::Apis::CivicinfoV2::CivicInfoService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-civicinfo_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-civicinfo_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/civic-information/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-civicinfo_v2/google-apis-civicinfo_v2.gemspec b/generated/google-apis-civicinfo_v2/google-apis-civicinfo_v2.gemspec index 3fa47d0d1..3e069f304 100644 --- a/generated/google-apis-civicinfo_v2/google-apis-civicinfo_v2.gemspec +++ b/generated/google-apis-civicinfo_v2/google-apis-civicinfo_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CivicinfoV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Civic Information API V2" + gem.summary = "Simple REST client for Google Civic Information API V2" gem.description = - "This is the legacy REST client for Google Civic Information API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Civic Information API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-civicinfo_v2/lib/google/apis/civicinfo_v2/gem_version.rb b/generated/google-apis-civicinfo_v2/lib/google/apis/civicinfo_v2/gem_version.rb index fe597380a..24bc160e8 100644 --- a/generated/google-apis-civicinfo_v2/lib/google/apis/civicinfo_v2/gem_version.rb +++ b/generated/google-apis-civicinfo_v2/lib/google/apis/civicinfo_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201012" diff --git a/generated/google-apis-classroom_v1/CHANGELOG.md b/generated/google-apis-classroom_v1/CHANGELOG.md index c1eed4965..c9ea1028a 100644 --- a/generated/google-apis-classroom_v1/CHANGELOG.md +++ b/generated/google-apis-classroom_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-classroom_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201012 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-classroom_v1/OVERVIEW.md b/generated/google-apis-classroom_v1/OVERVIEW.md index 05b3d59e0..a9354f440 100644 --- a/generated/google-apis-classroom_v1/OVERVIEW.md +++ b/generated/google-apis-classroom_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Classroom API +# Simple REST client for version V1 of the Google Classroom API This is a simple client library for version V1 of the Google Classroom API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Classroom API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Classroom service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Classroom service in particular.) For reference information on specific calls in the Google Classroom API, see the {Google::Apis::ClassroomV1::ClassroomService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-classroom_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-classroom_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/classroom/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-classroom_v1/google-apis-classroom_v1.gemspec b/generated/google-apis-classroom_v1/google-apis-classroom_v1.gemspec index 0421ad215..762d7538d 100644 --- a/generated/google-apis-classroom_v1/google-apis-classroom_v1.gemspec +++ b/generated/google-apis-classroom_v1/google-apis-classroom_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ClassroomV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Classroom API V1" + gem.summary = "Simple REST client for Google Classroom API V1" gem.description = - "This is the legacy REST client for Google Classroom API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Classroom API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/gem_version.rb b/generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/gem_version.rb index 1b5033fa1..f478a4e24 100644 --- a/generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/gem_version.rb +++ b/generated/google-apis-classroom_v1/lib/google/apis/classroom_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201012" diff --git a/generated/google-apis-cloudasset_v1/OVERVIEW.md b/generated/google-apis-cloudasset_v1/OVERVIEW.md index 224d32393..7f759ae10 100644 --- a/generated/google-apis-cloudasset_v1/OVERVIEW.md +++ b/generated/google-apis-cloudasset_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Asset API +# Simple REST client for version V1 of the Cloud Asset API This is a simple client library for version V1 of the Cloud Asset API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Asset API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudasset service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudasset service in particular.) For reference information on specific calls in the Cloud Asset API, see the {Google::Apis::CloudassetV1::CloudAssetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudasset_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudasset_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/asset-inventory/docs/quickstart) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudasset_v1/google-apis-cloudasset_v1.gemspec b/generated/google-apis-cloudasset_v1/google-apis-cloudasset_v1.gemspec index 8b0ca90f6..c78a459e2 100644 --- a/generated/google-apis-cloudasset_v1/google-apis-cloudasset_v1.gemspec +++ b/generated/google-apis-cloudasset_v1/google-apis-cloudasset_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudassetV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Asset API V1" + gem.summary = "Simple REST client for Cloud Asset API V1" gem.description = - "This is the legacy REST client for Cloud Asset API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Asset API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudasset_v1beta1/CHANGELOG.md b/generated/google-apis-cloudasset_v1beta1/CHANGELOG.md index 0302facca..1e2aa53d1 100644 --- a/generated/google-apis-cloudasset_v1beta1/CHANGELOG.md +++ b/generated/google-apis-cloudasset_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudasset_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudasset_v1beta1/OVERVIEW.md b/generated/google-apis-cloudasset_v1beta1/OVERVIEW.md index 9897bde65..e8857c815 100644 --- a/generated/google-apis-cloudasset_v1beta1/OVERVIEW.md +++ b/generated/google-apis-cloudasset_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Asset API +# Simple REST client for version V1beta1 of the Cloud Asset API This is a simple client library for version V1beta1 of the Cloud Asset API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Asset API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudasset service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudasset service in particular.) For reference information on specific calls in the Cloud Asset API, see the {Google::Apis::CloudassetV1beta1::CloudAssetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudasset_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudasset_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/asset-inventory/docs/quickstart) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudasset_v1beta1/google-apis-cloudasset_v1beta1.gemspec b/generated/google-apis-cloudasset_v1beta1/google-apis-cloudasset_v1beta1.gemspec index f6014b1be..29da170b9 100644 --- a/generated/google-apis-cloudasset_v1beta1/google-apis-cloudasset_v1beta1.gemspec +++ b/generated/google-apis-cloudasset_v1beta1/google-apis-cloudasset_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudassetV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Asset API V1beta1" + gem.summary = "Simple REST client for Cloud Asset API V1beta1" gem.description = - "This is the legacy REST client for Cloud Asset API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Asset API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudasset_v1beta1/lib/google/apis/cloudasset_v1beta1/gem_version.rb b/generated/google-apis-cloudasset_v1beta1/lib/google/apis/cloudasset_v1beta1/gem_version.rb index 381999ec8..d24ab00a0 100644 --- a/generated/google-apis-cloudasset_v1beta1/lib/google/apis/cloudasset_v1beta1/gem_version.rb +++ b/generated/google-apis-cloudasset_v1beta1/lib/google/apis/cloudasset_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-cloudasset_v1p1beta1/CHANGELOG.md b/generated/google-apis-cloudasset_v1p1beta1/CHANGELOG.md index 5247bae58..e4fb46474 100644 --- a/generated/google-apis-cloudasset_v1p1beta1/CHANGELOG.md +++ b/generated/google-apis-cloudasset_v1p1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudasset_v1p1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201106 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudasset_v1p1beta1/OVERVIEW.md b/generated/google-apis-cloudasset_v1p1beta1/OVERVIEW.md index ee8cf56b2..7a364e252 100644 --- a/generated/google-apis-cloudasset_v1p1beta1/OVERVIEW.md +++ b/generated/google-apis-cloudasset_v1p1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p1beta1 of the Cloud Asset API +# Simple REST client for version V1p1beta1 of the Cloud Asset API This is a simple client library for version V1p1beta1 of the Cloud Asset API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p1beta1 of the Cloud Asset API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudasset service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudasset service in particular.) For reference information on specific calls in the Cloud Asset API, see the {Google::Apis::CloudassetV1p1beta1::CloudAssetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudasset_v1p1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudasset_v1p1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/asset-inventory/docs/quickstart) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudasset_v1p1beta1/google-apis-cloudasset_v1p1beta1.gemspec b/generated/google-apis-cloudasset_v1p1beta1/google-apis-cloudasset_v1p1beta1.gemspec index 6ee0a6e96..c021fe123 100644 --- a/generated/google-apis-cloudasset_v1p1beta1/google-apis-cloudasset_v1p1beta1.gemspec +++ b/generated/google-apis-cloudasset_v1p1beta1/google-apis-cloudasset_v1p1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudassetV1p1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Asset API V1p1beta1" + gem.summary = "Simple REST client for Cloud Asset API V1p1beta1" gem.description = - "This is the legacy REST client for Cloud Asset API V1p1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Asset API V1p1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudasset_v1p1beta1/lib/google/apis/cloudasset_v1p1beta1/gem_version.rb b/generated/google-apis-cloudasset_v1p1beta1/lib/google/apis/cloudasset_v1p1beta1/gem_version.rb index 7ef13eeb6..e142dedce 100644 --- a/generated/google-apis-cloudasset_v1p1beta1/lib/google/apis/cloudasset_v1p1beta1/gem_version.rb +++ b/generated/google-apis-cloudasset_v1p1beta1/lib/google/apis/cloudasset_v1p1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201106" diff --git a/generated/google-apis-cloudasset_v1p4beta1/CHANGELOG.md b/generated/google-apis-cloudasset_v1p4beta1/CHANGELOG.md index 64687d39a..bc08574b0 100644 --- a/generated/google-apis-cloudasset_v1p4beta1/CHANGELOG.md +++ b/generated/google-apis-cloudasset_v1p4beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudasset_v1p4beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201106 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudasset_v1p4beta1/OVERVIEW.md b/generated/google-apis-cloudasset_v1p4beta1/OVERVIEW.md index 2854efda1..37583c259 100644 --- a/generated/google-apis-cloudasset_v1p4beta1/OVERVIEW.md +++ b/generated/google-apis-cloudasset_v1p4beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p4beta1 of the Cloud Asset API +# Simple REST client for version V1p4beta1 of the Cloud Asset API This is a simple client library for version V1p4beta1 of the Cloud Asset API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p4beta1 of the Cloud Asset API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudasset service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudasset service in particular.) For reference information on specific calls in the Cloud Asset API, see the {Google::Apis::CloudassetV1p4beta1::CloudAssetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudasset_v1p4beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudasset_v1p4beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/asset-inventory/docs/quickstart) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudasset_v1p4beta1/google-apis-cloudasset_v1p4beta1.gemspec b/generated/google-apis-cloudasset_v1p4beta1/google-apis-cloudasset_v1p4beta1.gemspec index f5051cc15..28f368c80 100644 --- a/generated/google-apis-cloudasset_v1p4beta1/google-apis-cloudasset_v1p4beta1.gemspec +++ b/generated/google-apis-cloudasset_v1p4beta1/google-apis-cloudasset_v1p4beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudassetV1p4beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Asset API V1p4beta1" + gem.summary = "Simple REST client for Cloud Asset API V1p4beta1" gem.description = - "This is the legacy REST client for Cloud Asset API V1p4beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Asset API V1p4beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudasset_v1p4beta1/lib/google/apis/cloudasset_v1p4beta1/gem_version.rb b/generated/google-apis-cloudasset_v1p4beta1/lib/google/apis/cloudasset_v1p4beta1/gem_version.rb index e90345f39..74d92651c 100644 --- a/generated/google-apis-cloudasset_v1p4beta1/lib/google/apis/cloudasset_v1p4beta1/gem_version.rb +++ b/generated/google-apis-cloudasset_v1p4beta1/lib/google/apis/cloudasset_v1p4beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201106" diff --git a/generated/google-apis-cloudasset_v1p5beta1/CHANGELOG.md b/generated/google-apis-cloudasset_v1p5beta1/CHANGELOG.md index fd33f87cb..98dae52d8 100644 --- a/generated/google-apis-cloudasset_v1p5beta1/CHANGELOG.md +++ b/generated/google-apis-cloudasset_v1p5beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudasset_v1p5beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudasset_v1p5beta1/OVERVIEW.md b/generated/google-apis-cloudasset_v1p5beta1/OVERVIEW.md index 586e34e85..cf11bae63 100644 --- a/generated/google-apis-cloudasset_v1p5beta1/OVERVIEW.md +++ b/generated/google-apis-cloudasset_v1p5beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p5beta1 of the Cloud Asset API +# Simple REST client for version V1p5beta1 of the Cloud Asset API This is a simple client library for version V1p5beta1 of the Cloud Asset API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p5beta1 of the Cloud Asset API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudasset service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudasset service in particular.) For reference information on specific calls in the Cloud Asset API, see the {Google::Apis::CloudassetV1p5beta1::CloudAssetService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudasset_v1p5beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudasset_v1p5beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/asset-inventory/docs/quickstart) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudasset_v1p5beta1/google-apis-cloudasset_v1p5beta1.gemspec b/generated/google-apis-cloudasset_v1p5beta1/google-apis-cloudasset_v1p5beta1.gemspec index 1ffa2875e..c4e70a39e 100644 --- a/generated/google-apis-cloudasset_v1p5beta1/google-apis-cloudasset_v1p5beta1.gemspec +++ b/generated/google-apis-cloudasset_v1p5beta1/google-apis-cloudasset_v1p5beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudassetV1p5beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Asset API V1p5beta1" + gem.summary = "Simple REST client for Cloud Asset API V1p5beta1" gem.description = - "This is the legacy REST client for Cloud Asset API V1p5beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Asset API V1p5beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudasset_v1p5beta1/lib/google/apis/cloudasset_v1p5beta1/gem_version.rb b/generated/google-apis-cloudasset_v1p5beta1/lib/google/apis/cloudasset_v1p5beta1/gem_version.rb index 96422a32a..92f0d7ff2 100644 --- a/generated/google-apis-cloudasset_v1p5beta1/lib/google/apis/cloudasset_v1p5beta1/gem_version.rb +++ b/generated/google-apis-cloudasset_v1p5beta1/lib/google/apis/cloudasset_v1p5beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-cloudbilling_v1/CHANGELOG.md b/generated/google-apis-cloudbilling_v1/CHANGELOG.md index f34fe7591..fd38531bc 100644 --- a/generated/google-apis-cloudbilling_v1/CHANGELOG.md +++ b/generated/google-apis-cloudbilling_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudbilling_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201017 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudbilling_v1/OVERVIEW.md b/generated/google-apis-cloudbilling_v1/OVERVIEW.md index 540414325..3ce609048 100644 --- a/generated/google-apis-cloudbilling_v1/OVERVIEW.md +++ b/generated/google-apis-cloudbilling_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Billing API +# Simple REST client for version V1 of the Cloud Billing API This is a simple client library for version V1 of the Cloud Billing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Billing API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudbilling service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudbilling service in particular.) For reference information on specific calls in the Cloud Billing API, see the {Google::Apis::CloudbillingV1::CloudbillingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudbilling_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudbilling_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/billing/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudbilling_v1/google-apis-cloudbilling_v1.gemspec b/generated/google-apis-cloudbilling_v1/google-apis-cloudbilling_v1.gemspec index a95b13066..47095528b 100644 --- a/generated/google-apis-cloudbilling_v1/google-apis-cloudbilling_v1.gemspec +++ b/generated/google-apis-cloudbilling_v1/google-apis-cloudbilling_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudbillingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Billing API V1" + gem.summary = "Simple REST client for Cloud Billing API V1" gem.description = - "This is the legacy REST client for Cloud Billing API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Billing API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudbilling_v1/lib/google/apis/cloudbilling_v1/gem_version.rb b/generated/google-apis-cloudbilling_v1/lib/google/apis/cloudbilling_v1/gem_version.rb index 031edcfca..e7d006403 100644 --- a/generated/google-apis-cloudbilling_v1/lib/google/apis/cloudbilling_v1/gem_version.rb +++ b/generated/google-apis-cloudbilling_v1/lib/google/apis/cloudbilling_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201017" diff --git a/generated/google-apis-cloudbuild_v1/CHANGELOG.md b/generated/google-apis-cloudbuild_v1/CHANGELOG.md index 0e79a1702..bd568a984 100644 --- a/generated/google-apis-cloudbuild_v1/CHANGELOG.md +++ b/generated/google-apis-cloudbuild_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudbuild_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudbuild_v1/OVERVIEW.md b/generated/google-apis-cloudbuild_v1/OVERVIEW.md index 3636676ce..89395577d 100644 --- a/generated/google-apis-cloudbuild_v1/OVERVIEW.md +++ b/generated/google-apis-cloudbuild_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Build API +# Simple REST client for version V1 of the Cloud Build API This is a simple client library for version V1 of the Cloud Build API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Build API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudbuild service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudbuild service in particular.) For reference information on specific calls in the Cloud Build API, see the {Google::Apis::CloudbuildV1::CloudBuildService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudbuild_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudbuild_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/cloud-build/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudbuild_v1/google-apis-cloudbuild_v1.gemspec b/generated/google-apis-cloudbuild_v1/google-apis-cloudbuild_v1.gemspec index ea7307c60..1eb1f595f 100644 --- a/generated/google-apis-cloudbuild_v1/google-apis-cloudbuild_v1.gemspec +++ b/generated/google-apis-cloudbuild_v1/google-apis-cloudbuild_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudbuildV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Build API V1" + gem.summary = "Simple REST client for Cloud Build API V1" gem.description = - "This is the legacy REST client for Cloud Build API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Build API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudbuild_v1/lib/google/apis/cloudbuild_v1/gem_version.rb b/generated/google-apis-cloudbuild_v1/lib/google/apis/cloudbuild_v1/gem_version.rb index ba1e00fa7..996db9134 100644 --- a/generated/google-apis-cloudbuild_v1/lib/google/apis/cloudbuild_v1/gem_version.rb +++ b/generated/google-apis-cloudbuild_v1/lib/google/apis/cloudbuild_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-cloudbuild_v1alpha1/CHANGELOG.md b/generated/google-apis-cloudbuild_v1alpha1/CHANGELOG.md index e4fedd885..85f84f419 100644 --- a/generated/google-apis-cloudbuild_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-cloudbuild_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudbuild_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudbuild_v1alpha1/OVERVIEW.md b/generated/google-apis-cloudbuild_v1alpha1/OVERVIEW.md index a124b7739..ef29bd52c 100644 --- a/generated/google-apis-cloudbuild_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-cloudbuild_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Cloud Build API +# Simple REST client for version V1alpha1 of the Cloud Build API This is a simple client library for version V1alpha1 of the Cloud Build API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Cloud Build API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudbuild service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudbuild service in particular.) For reference information on specific calls in the Cloud Build API, see the {Google::Apis::CloudbuildV1alpha1::CloudBuildService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudbuild_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudbuild_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/cloud-build/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudbuild_v1alpha1/google-apis-cloudbuild_v1alpha1.gemspec b/generated/google-apis-cloudbuild_v1alpha1/google-apis-cloudbuild_v1alpha1.gemspec index ac9d571c0..df1d3388c 100644 --- a/generated/google-apis-cloudbuild_v1alpha1/google-apis-cloudbuild_v1alpha1.gemspec +++ b/generated/google-apis-cloudbuild_v1alpha1/google-apis-cloudbuild_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudbuildV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Build API V1alpha1" + gem.summary = "Simple REST client for Cloud Build API V1alpha1" gem.description = - "This is the legacy REST client for Cloud Build API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Build API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudbuild_v1alpha1/lib/google/apis/cloudbuild_v1alpha1/gem_version.rb b/generated/google-apis-cloudbuild_v1alpha1/lib/google/apis/cloudbuild_v1alpha1/gem_version.rb index 487f7a9a9..9921f3699 100644 --- a/generated/google-apis-cloudbuild_v1alpha1/lib/google/apis/cloudbuild_v1alpha1/gem_version.rb +++ b/generated/google-apis-cloudbuild_v1alpha1/lib/google/apis/cloudbuild_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-cloudbuild_v1alpha2/CHANGELOG.md b/generated/google-apis-cloudbuild_v1alpha2/CHANGELOG.md index 8c4c30d05..80a93f9ad 100644 --- a/generated/google-apis-cloudbuild_v1alpha2/CHANGELOG.md +++ b/generated/google-apis-cloudbuild_v1alpha2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudbuild_v1alpha2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudbuild_v1alpha2/OVERVIEW.md b/generated/google-apis-cloudbuild_v1alpha2/OVERVIEW.md index b9d7969a4..cd7a24f45 100644 --- a/generated/google-apis-cloudbuild_v1alpha2/OVERVIEW.md +++ b/generated/google-apis-cloudbuild_v1alpha2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha2 of the Cloud Build API +# Simple REST client for version V1alpha2 of the Cloud Build API This is a simple client library for version V1alpha2 of the Cloud Build API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha2 of the Cloud Build API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudbuild service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudbuild service in particular.) For reference information on specific calls in the Cloud Build API, see the {Google::Apis::CloudbuildV1alpha2::CloudBuildService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudbuild_v1alpha2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudbuild_v1alpha2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/cloud-build/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudbuild_v1alpha2/google-apis-cloudbuild_v1alpha2.gemspec b/generated/google-apis-cloudbuild_v1alpha2/google-apis-cloudbuild_v1alpha2.gemspec index 7bd93406c..839867541 100644 --- a/generated/google-apis-cloudbuild_v1alpha2/google-apis-cloudbuild_v1alpha2.gemspec +++ b/generated/google-apis-cloudbuild_v1alpha2/google-apis-cloudbuild_v1alpha2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudbuildV1alpha2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Build API V1alpha2" + gem.summary = "Simple REST client for Cloud Build API V1alpha2" gem.description = - "This is the legacy REST client for Cloud Build API V1alpha2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Build API V1alpha2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudbuild_v1alpha2/lib/google/apis/cloudbuild_v1alpha2/gem_version.rb b/generated/google-apis-cloudbuild_v1alpha2/lib/google/apis/cloudbuild_v1alpha2/gem_version.rb index 6aff5c411..519423486 100644 --- a/generated/google-apis-cloudbuild_v1alpha2/lib/google/apis/cloudbuild_v1alpha2/gem_version.rb +++ b/generated/google-apis-cloudbuild_v1alpha2/lib/google/apis/cloudbuild_v1alpha2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-clouddebugger_v2/CHANGELOG.md b/generated/google-apis-clouddebugger_v2/CHANGELOG.md index 4ff0ea495..e46587710 100644 --- a/generated/google-apis-clouddebugger_v2/CHANGELOG.md +++ b/generated/google-apis-clouddebugger_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-clouddebugger_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200807 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-clouddebugger_v2/OVERVIEW.md b/generated/google-apis-clouddebugger_v2/OVERVIEW.md index a69b6b518..a4d517b86 100644 --- a/generated/google-apis-clouddebugger_v2/OVERVIEW.md +++ b/generated/google-apis-clouddebugger_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Debugger API +# Simple REST client for version V2 of the Cloud Debugger API This is a simple client library for version V2 of the Cloud Debugger API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Debugger API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Clouddebugger service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Clouddebugger service in particular.) For reference information on specific calls in the Cloud Debugger API, see the {Google::Apis::ClouddebuggerV2::CloudDebuggerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-clouddebugger_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-clouddebugger_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/debugger) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-clouddebugger_v2/google-apis-clouddebugger_v2.gemspec b/generated/google-apis-clouddebugger_v2/google-apis-clouddebugger_v2.gemspec index 5e0d46f81..5809a7e72 100644 --- a/generated/google-apis-clouddebugger_v2/google-apis-clouddebugger_v2.gemspec +++ b/generated/google-apis-clouddebugger_v2/google-apis-clouddebugger_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ClouddebuggerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Debugger API V2" + gem.summary = "Simple REST client for Cloud Debugger API V2" gem.description = - "This is the legacy REST client for Cloud Debugger API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Debugger API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-clouddebugger_v2/lib/google/apis/clouddebugger_v2/gem_version.rb b/generated/google-apis-clouddebugger_v2/lib/google/apis/clouddebugger_v2/gem_version.rb index 94c8c6749..a60f6428c 100644 --- a/generated/google-apis-clouddebugger_v2/lib/google/apis/clouddebugger_v2/gem_version.rb +++ b/generated/google-apis-clouddebugger_v2/lib/google/apis/clouddebugger_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200807" diff --git a/generated/google-apis-clouderrorreporting_v1beta1/CHANGELOG.md b/generated/google-apis-clouderrorreporting_v1beta1/CHANGELOG.md index 191178bda..ffa900694 100644 --- a/generated/google-apis-clouderrorreporting_v1beta1/CHANGELOG.md +++ b/generated/google-apis-clouderrorreporting_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-clouderrorreporting_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200827 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-clouderrorreporting_v1beta1/OVERVIEW.md b/generated/google-apis-clouderrorreporting_v1beta1/OVERVIEW.md index faf7ab3a5..d38a16625 100644 --- a/generated/google-apis-clouderrorreporting_v1beta1/OVERVIEW.md +++ b/generated/google-apis-clouderrorreporting_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Error Reporting API +# Simple REST client for version V1beta1 of the Error Reporting API This is a simple client library for version V1beta1 of the Error Reporting API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Error Reporting API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Clouderrorreporting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Clouderrorreporting service in particular.) For reference information on specific calls in the Error Reporting API, see the {Google::Apis::ClouderrorreportingV1beta1::ClouderrorreportingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-clouderrorreporting_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-clouderrorreporting_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/error-reporting/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-clouderrorreporting_v1beta1/google-apis-clouderrorreporting_v1beta1.gemspec b/generated/google-apis-clouderrorreporting_v1beta1/google-apis-clouderrorreporting_v1beta1.gemspec index fcf963da7..5e9d1f22d 100644 --- a/generated/google-apis-clouderrorreporting_v1beta1/google-apis-clouderrorreporting_v1beta1.gemspec +++ b/generated/google-apis-clouderrorreporting_v1beta1/google-apis-clouderrorreporting_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ClouderrorreportingV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Error Reporting API V1beta1" + gem.summary = "Simple REST client for Error Reporting API V1beta1" gem.description = - "This is the legacy REST client for Error Reporting API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Error Reporting API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-clouderrorreporting_v1beta1/lib/google/apis/clouderrorreporting_v1beta1/gem_version.rb b/generated/google-apis-clouderrorreporting_v1beta1/lib/google/apis/clouderrorreporting_v1beta1/gem_version.rb index 2155e62e7..a385cf554 100644 --- a/generated/google-apis-clouderrorreporting_v1beta1/lib/google/apis/clouderrorreporting_v1beta1/gem_version.rb +++ b/generated/google-apis-clouderrorreporting_v1beta1/lib/google/apis/clouderrorreporting_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200827" diff --git a/generated/google-apis-cloudfunctions_v1/CHANGELOG.md b/generated/google-apis-cloudfunctions_v1/CHANGELOG.md index 53f8afbcb..ebeae24f1 100644 --- a/generated/google-apis-cloudfunctions_v1/CHANGELOG.md +++ b/generated/google-apis-cloudfunctions_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudfunctions_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudfunctions_v1/OVERVIEW.md b/generated/google-apis-cloudfunctions_v1/OVERVIEW.md index 4cd054720..c90ac9b3b 100644 --- a/generated/google-apis-cloudfunctions_v1/OVERVIEW.md +++ b/generated/google-apis-cloudfunctions_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Functions API +# Simple REST client for version V1 of the Cloud Functions API This is a simple client library for version V1 of the Cloud Functions API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Functions API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudfunctions service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudfunctions service in particular.) For reference information on specific calls in the Cloud Functions API, see the {Google::Apis::CloudfunctionsV1::CloudFunctionsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudfunctions_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudfunctions_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/functions) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudfunctions_v1/google-apis-cloudfunctions_v1.gemspec b/generated/google-apis-cloudfunctions_v1/google-apis-cloudfunctions_v1.gemspec index 2a4e2720a..c22ff5881 100644 --- a/generated/google-apis-cloudfunctions_v1/google-apis-cloudfunctions_v1.gemspec +++ b/generated/google-apis-cloudfunctions_v1/google-apis-cloudfunctions_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudfunctionsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Functions API V1" + gem.summary = "Simple REST client for Cloud Functions API V1" gem.description = - "This is the legacy REST client for Cloud Functions API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Functions API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudfunctions_v1/lib/google/apis/cloudfunctions_v1/gem_version.rb b/generated/google-apis-cloudfunctions_v1/lib/google/apis/cloudfunctions_v1/gem_version.rb index dd9b64440..2ae73c525 100644 --- a/generated/google-apis-cloudfunctions_v1/lib/google/apis/cloudfunctions_v1/gem_version.rb +++ b/generated/google-apis-cloudfunctions_v1/lib/google/apis/cloudfunctions_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-cloudidentity_v1/CHANGELOG.md b/generated/google-apis-cloudidentity_v1/CHANGELOG.md index 6a31c1e54..0ac483e4f 100644 --- a/generated/google-apis-cloudidentity_v1/CHANGELOG.md +++ b/generated/google-apis-cloudidentity_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudidentity_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudidentity_v1/OVERVIEW.md b/generated/google-apis-cloudidentity_v1/OVERVIEW.md index 622c6daa2..c669ca276 100644 --- a/generated/google-apis-cloudidentity_v1/OVERVIEW.md +++ b/generated/google-apis-cloudidentity_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Identity API +# Simple REST client for version V1 of the Cloud Identity API This is a simple client library for version V1 of the Cloud Identity API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Identity API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudidentity service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudidentity service in particular.) For reference information on specific calls in the Cloud Identity API, see the {Google::Apis::CloudidentityV1::CloudIdentityService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudidentity_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudidentity_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/identity/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudidentity_v1/google-apis-cloudidentity_v1.gemspec b/generated/google-apis-cloudidentity_v1/google-apis-cloudidentity_v1.gemspec index 6cacc54f1..e92f7a726 100644 --- a/generated/google-apis-cloudidentity_v1/google-apis-cloudidentity_v1.gemspec +++ b/generated/google-apis-cloudidentity_v1/google-apis-cloudidentity_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudidentityV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Identity API V1" + gem.summary = "Simple REST client for Cloud Identity API V1" gem.description = - "This is the legacy REST client for Cloud Identity API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Identity API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudidentity_v1/lib/google/apis/cloudidentity_v1/gem_version.rb b/generated/google-apis-cloudidentity_v1/lib/google/apis/cloudidentity_v1/gem_version.rb index 1ce074499..70e289db6 100644 --- a/generated/google-apis-cloudidentity_v1/lib/google/apis/cloudidentity_v1/gem_version.rb +++ b/generated/google-apis-cloudidentity_v1/lib/google/apis/cloudidentity_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-cloudidentity_v1beta1/CHANGELOG.md b/generated/google-apis-cloudidentity_v1beta1/CHANGELOG.md index c835c98ea..596ed7741 100644 --- a/generated/google-apis-cloudidentity_v1beta1/CHANGELOG.md +++ b/generated/google-apis-cloudidentity_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudidentity_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudidentity_v1beta1/OVERVIEW.md b/generated/google-apis-cloudidentity_v1beta1/OVERVIEW.md index e40969c93..05d009cb0 100644 --- a/generated/google-apis-cloudidentity_v1beta1/OVERVIEW.md +++ b/generated/google-apis-cloudidentity_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Identity API +# Simple REST client for version V1beta1 of the Cloud Identity API This is a simple client library for version V1beta1 of the Cloud Identity API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Identity API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudidentity service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudidentity service in particular.) For reference information on specific calls in the Cloud Identity API, see the {Google::Apis::CloudidentityV1beta1::CloudIdentityService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudidentity_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudidentity_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/identity/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudidentity_v1beta1/google-apis-cloudidentity_v1beta1.gemspec b/generated/google-apis-cloudidentity_v1beta1/google-apis-cloudidentity_v1beta1.gemspec index 37752689e..81c9af7da 100644 --- a/generated/google-apis-cloudidentity_v1beta1/google-apis-cloudidentity_v1beta1.gemspec +++ b/generated/google-apis-cloudidentity_v1beta1/google-apis-cloudidentity_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudidentityV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Identity API V1beta1" + gem.summary = "Simple REST client for Cloud Identity API V1beta1" gem.description = - "This is the legacy REST client for Cloud Identity API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Identity API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudidentity_v1beta1/lib/google/apis/cloudidentity_v1beta1/gem_version.rb b/generated/google-apis-cloudidentity_v1beta1/lib/google/apis/cloudidentity_v1beta1/gem_version.rb index f5fc3ec48..424625078 100644 --- a/generated/google-apis-cloudidentity_v1beta1/lib/google/apis/cloudidentity_v1beta1/gem_version.rb +++ b/generated/google-apis-cloudidentity_v1beta1/lib/google/apis/cloudidentity_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201213" diff --git a/generated/google-apis-cloudiot_v1/CHANGELOG.md b/generated/google-apis-cloudiot_v1/CHANGELOG.md index f0297fc6f..3386de5c1 100644 --- a/generated/google-apis-cloudiot_v1/CHANGELOG.md +++ b/generated/google-apis-cloudiot_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudiot_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201110 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudiot_v1/OVERVIEW.md b/generated/google-apis-cloudiot_v1/OVERVIEW.md index a7637b794..6ac583da7 100644 --- a/generated/google-apis-cloudiot_v1/OVERVIEW.md +++ b/generated/google-apis-cloudiot_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud IoT API +# Simple REST client for version V1 of the Cloud IoT API This is a simple client library for version V1 of the Cloud IoT API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud IoT API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudiot service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudiot service in particular.) For reference information on specific calls in the Cloud IoT API, see the {Google::Apis::CloudiotV1::CloudIotService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudiot_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudiot_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iot) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudiot_v1/google-apis-cloudiot_v1.gemspec b/generated/google-apis-cloudiot_v1/google-apis-cloudiot_v1.gemspec index 29ef968d4..f27031b12 100644 --- a/generated/google-apis-cloudiot_v1/google-apis-cloudiot_v1.gemspec +++ b/generated/google-apis-cloudiot_v1/google-apis-cloudiot_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudiotV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud IoT API V1" + gem.summary = "Simple REST client for Cloud IoT API V1" gem.description = - "This is the legacy REST client for Cloud IoT API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud IoT API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudiot_v1/lib/google/apis/cloudiot_v1/gem_version.rb b/generated/google-apis-cloudiot_v1/lib/google/apis/cloudiot_v1/gem_version.rb index b1eb43396..19ea310aa 100644 --- a/generated/google-apis-cloudiot_v1/lib/google/apis/cloudiot_v1/gem_version.rb +++ b/generated/google-apis-cloudiot_v1/lib/google/apis/cloudiot_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201110" diff --git a/generated/google-apis-cloudkms_v1/CHANGELOG.md b/generated/google-apis-cloudkms_v1/CHANGELOG.md index 515f99dc2..4fa954d25 100644 --- a/generated/google-apis-cloudkms_v1/CHANGELOG.md +++ b/generated/google-apis-cloudkms_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudkms_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudkms_v1/OVERVIEW.md b/generated/google-apis-cloudkms_v1/OVERVIEW.md index 393ec70d6..095d1217a 100644 --- a/generated/google-apis-cloudkms_v1/OVERVIEW.md +++ b/generated/google-apis-cloudkms_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Key Management Service (KMS) API +# Simple REST client for version V1 of the Cloud Key Management Service (KMS) API This is a simple client library for version V1 of the Cloud Key Management Service (KMS) API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Key Management Servi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudkms service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudkms service in particular.) For reference information on specific calls in the Cloud Key Management Service (KMS) API, see the {Google::Apis::CloudkmsV1::CloudKMSService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudkms_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudkms_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/kms/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudkms_v1/google-apis-cloudkms_v1.gemspec b/generated/google-apis-cloudkms_v1/google-apis-cloudkms_v1.gemspec index 229279928..7c4678acd 100644 --- a/generated/google-apis-cloudkms_v1/google-apis-cloudkms_v1.gemspec +++ b/generated/google-apis-cloudkms_v1/google-apis-cloudkms_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudkmsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Key Management Service (KMS) API V1" + gem.summary = "Simple REST client for Cloud Key Management Service (KMS) API V1" gem.description = - "This is the legacy REST client for Cloud Key Management Service (KMS) API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Key Management Service (KMS) API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudkms_v1/lib/google/apis/cloudkms_v1/gem_version.rb b/generated/google-apis-cloudkms_v1/lib/google/apis/cloudkms_v1/gem_version.rb index b1f149e4c..c32d42762 100644 --- a/generated/google-apis-cloudkms_v1/lib/google/apis/cloudkms_v1/gem_version.rb +++ b/generated/google-apis-cloudkms_v1/lib/google/apis/cloudkms_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-cloudprofiler_v2/CHANGELOG.md b/generated/google-apis-cloudprofiler_v2/CHANGELOG.md index 646fc1cef..c21f72fea 100644 --- a/generated/google-apis-cloudprofiler_v2/CHANGELOG.md +++ b/generated/google-apis-cloudprofiler_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudprofiler_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200822 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudprofiler_v2/OVERVIEW.md b/generated/google-apis-cloudprofiler_v2/OVERVIEW.md index 0e4b06ac3..b41ab9cbf 100644 --- a/generated/google-apis-cloudprofiler_v2/OVERVIEW.md +++ b/generated/google-apis-cloudprofiler_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Stackdriver Profiler API +# Simple REST client for version V2 of the Stackdriver Profiler API This is a simple client library for version V2 of the Stackdriver Profiler API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Stackdriver Profiler API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudprofiler service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudprofiler service in particular.) For reference information on specific calls in the Stackdriver Profiler API, see the {Google::Apis::CloudprofilerV2::CloudProfilerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudprofiler_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudprofiler_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/profiler/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudprofiler_v2/google-apis-cloudprofiler_v2.gemspec b/generated/google-apis-cloudprofiler_v2/google-apis-cloudprofiler_v2.gemspec index b32448360..f2fd39d0e 100644 --- a/generated/google-apis-cloudprofiler_v2/google-apis-cloudprofiler_v2.gemspec +++ b/generated/google-apis-cloudprofiler_v2/google-apis-cloudprofiler_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudprofilerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Stackdriver Profiler API V2" + gem.summary = "Simple REST client for Stackdriver Profiler API V2" gem.description = - "This is the legacy REST client for Stackdriver Profiler API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Stackdriver Profiler API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudprofiler_v2/lib/google/apis/cloudprofiler_v2/gem_version.rb b/generated/google-apis-cloudprofiler_v2/lib/google/apis/cloudprofiler_v2/gem_version.rb index d4d9a1e4a..f75bd8ae9 100644 --- a/generated/google-apis-cloudprofiler_v2/lib/google/apis/cloudprofiler_v2/gem_version.rb +++ b/generated/google-apis-cloudprofiler_v2/lib/google/apis/cloudprofiler_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200822" diff --git a/generated/google-apis-cloudresourcemanager_v1/CHANGELOG.md b/generated/google-apis-cloudresourcemanager_v1/CHANGELOG.md index 8a95c6cd6..06c9cc054 100644 --- a/generated/google-apis-cloudresourcemanager_v1/CHANGELOG.md +++ b/generated/google-apis-cloudresourcemanager_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudresourcemanager_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudresourcemanager_v1/OVERVIEW.md b/generated/google-apis-cloudresourcemanager_v1/OVERVIEW.md index 4c7145628..fc45f97e4 100644 --- a/generated/google-apis-cloudresourcemanager_v1/OVERVIEW.md +++ b/generated/google-apis-cloudresourcemanager_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Resource Manager API +# Simple REST client for version V1 of the Cloud Resource Manager API This is a simple client library for version V1 of the Cloud Resource Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Resource Manager API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) For reference information on specific calls in the Cloud Resource Manager API, see the {Google::Apis::CloudresourcemanagerV1::CloudResourceManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudresourcemanager_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudresourcemanager_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/resource-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudresourcemanager_v1/google-apis-cloudresourcemanager_v1.gemspec b/generated/google-apis-cloudresourcemanager_v1/google-apis-cloudresourcemanager_v1.gemspec index 9b5a80d6d..34420f27d 100644 --- a/generated/google-apis-cloudresourcemanager_v1/google-apis-cloudresourcemanager_v1.gemspec +++ b/generated/google-apis-cloudresourcemanager_v1/google-apis-cloudresourcemanager_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudresourcemanagerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Resource Manager API V1" + gem.summary = "Simple REST client for Cloud Resource Manager API V1" gem.description = - "This is the legacy REST client for Cloud Resource Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Resource Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudresourcemanager_v1/lib/google/apis/cloudresourcemanager_v1/gem_version.rb b/generated/google-apis-cloudresourcemanager_v1/lib/google/apis/cloudresourcemanager_v1/gem_version.rb index 034da681f..fe86b8c98 100644 --- a/generated/google-apis-cloudresourcemanager_v1/lib/google/apis/cloudresourcemanager_v1/gem_version.rb +++ b/generated/google-apis-cloudresourcemanager_v1/lib/google/apis/cloudresourcemanager_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-cloudresourcemanager_v1beta1/CHANGELOG.md b/generated/google-apis-cloudresourcemanager_v1beta1/CHANGELOG.md index 5d373d578..6291346d4 100644 --- a/generated/google-apis-cloudresourcemanager_v1beta1/CHANGELOG.md +++ b/generated/google-apis-cloudresourcemanager_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudresourcemanager_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudresourcemanager_v1beta1/OVERVIEW.md b/generated/google-apis-cloudresourcemanager_v1beta1/OVERVIEW.md index 0a8f80659..bcfbdeb5d 100644 --- a/generated/google-apis-cloudresourcemanager_v1beta1/OVERVIEW.md +++ b/generated/google-apis-cloudresourcemanager_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Resource Manager API +# Simple REST client for version V1beta1 of the Cloud Resource Manager API This is a simple client library for version V1beta1 of the Cloud Resource Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Resource Manage * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) For reference information on specific calls in the Cloud Resource Manager API, see the {Google::Apis::CloudresourcemanagerV1beta1::CloudResourceManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudresourcemanager_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudresourcemanager_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/resource-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudresourcemanager_v1beta1/google-apis-cloudresourcemanager_v1beta1.gemspec b/generated/google-apis-cloudresourcemanager_v1beta1/google-apis-cloudresourcemanager_v1beta1.gemspec index 732d2c291..64922ce1d 100644 --- a/generated/google-apis-cloudresourcemanager_v1beta1/google-apis-cloudresourcemanager_v1beta1.gemspec +++ b/generated/google-apis-cloudresourcemanager_v1beta1/google-apis-cloudresourcemanager_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudresourcemanagerV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Resource Manager API V1beta1" + gem.summary = "Simple REST client for Cloud Resource Manager API V1beta1" gem.description = - "This is the legacy REST client for Cloud Resource Manager API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Resource Manager API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudresourcemanager_v1beta1/lib/google/apis/cloudresourcemanager_v1beta1/gem_version.rb b/generated/google-apis-cloudresourcemanager_v1beta1/lib/google/apis/cloudresourcemanager_v1beta1/gem_version.rb index 0c6a5b79f..c764865f9 100644 --- a/generated/google-apis-cloudresourcemanager_v1beta1/lib/google/apis/cloudresourcemanager_v1beta1/gem_version.rb +++ b/generated/google-apis-cloudresourcemanager_v1beta1/lib/google/apis/cloudresourcemanager_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-cloudresourcemanager_v2/CHANGELOG.md b/generated/google-apis-cloudresourcemanager_v2/CHANGELOG.md index 9c1272a17..94af58646 100644 --- a/generated/google-apis-cloudresourcemanager_v2/CHANGELOG.md +++ b/generated/google-apis-cloudresourcemanager_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudresourcemanager_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudresourcemanager_v2/OVERVIEW.md b/generated/google-apis-cloudresourcemanager_v2/OVERVIEW.md index b44299520..db70b0cca 100644 --- a/generated/google-apis-cloudresourcemanager_v2/OVERVIEW.md +++ b/generated/google-apis-cloudresourcemanager_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Resource Manager API +# Simple REST client for version V2 of the Cloud Resource Manager API This is a simple client library for version V2 of the Cloud Resource Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Resource Manager API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) For reference information on specific calls in the Cloud Resource Manager API, see the {Google::Apis::CloudresourcemanagerV2::CloudResourceManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudresourcemanager_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudresourcemanager_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/resource-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudresourcemanager_v2/google-apis-cloudresourcemanager_v2.gemspec b/generated/google-apis-cloudresourcemanager_v2/google-apis-cloudresourcemanager_v2.gemspec index f85853af5..e92a6216c 100644 --- a/generated/google-apis-cloudresourcemanager_v2/google-apis-cloudresourcemanager_v2.gemspec +++ b/generated/google-apis-cloudresourcemanager_v2/google-apis-cloudresourcemanager_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudresourcemanagerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Resource Manager API V2" + gem.summary = "Simple REST client for Cloud Resource Manager API V2" gem.description = - "This is the legacy REST client for Cloud Resource Manager API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Resource Manager API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudresourcemanager_v2/lib/google/apis/cloudresourcemanager_v2/gem_version.rb b/generated/google-apis-cloudresourcemanager_v2/lib/google/apis/cloudresourcemanager_v2/gem_version.rb index cb182f1bf..7c1b7b9c7 100644 --- a/generated/google-apis-cloudresourcemanager_v2/lib/google/apis/cloudresourcemanager_v2/gem_version.rb +++ b/generated/google-apis-cloudresourcemanager_v2/lib/google/apis/cloudresourcemanager_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-cloudresourcemanager_v2beta1/CHANGELOG.md b/generated/google-apis-cloudresourcemanager_v2beta1/CHANGELOG.md index d4b50c958..1a25c5d42 100644 --- a/generated/google-apis-cloudresourcemanager_v2beta1/CHANGELOG.md +++ b/generated/google-apis-cloudresourcemanager_v2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudresourcemanager_v2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudresourcemanager_v2beta1/OVERVIEW.md b/generated/google-apis-cloudresourcemanager_v2beta1/OVERVIEW.md index 14a7e39e2..ba71bccf8 100644 --- a/generated/google-apis-cloudresourcemanager_v2beta1/OVERVIEW.md +++ b/generated/google-apis-cloudresourcemanager_v2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta1 of the Cloud Resource Manager API +# Simple REST client for version V2beta1 of the Cloud Resource Manager API This is a simple client library for version V2beta1 of the Cloud Resource Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta1 of the Cloud Resource Manage * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudresourcemanager service in particular.) For reference information on specific calls in the Cloud Resource Manager API, see the {Google::Apis::CloudresourcemanagerV2beta1::CloudResourceManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudresourcemanager_v2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudresourcemanager_v2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/resource-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudresourcemanager_v2beta1/google-apis-cloudresourcemanager_v2beta1.gemspec b/generated/google-apis-cloudresourcemanager_v2beta1/google-apis-cloudresourcemanager_v2beta1.gemspec index 05b5778b4..216272a63 100644 --- a/generated/google-apis-cloudresourcemanager_v2beta1/google-apis-cloudresourcemanager_v2beta1.gemspec +++ b/generated/google-apis-cloudresourcemanager_v2beta1/google-apis-cloudresourcemanager_v2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudresourcemanagerV2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Resource Manager API V2beta1" + gem.summary = "Simple REST client for Cloud Resource Manager API V2beta1" gem.description = - "This is the legacy REST client for Cloud Resource Manager API V2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Resource Manager API V2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudresourcemanager_v2beta1/lib/google/apis/cloudresourcemanager_v2beta1/gem_version.rb b/generated/google-apis-cloudresourcemanager_v2beta1/lib/google/apis/cloudresourcemanager_v2beta1/gem_version.rb index 2c1039b07..7ee99959b 100644 --- a/generated/google-apis-cloudresourcemanager_v2beta1/lib/google/apis/cloudresourcemanager_v2beta1/gem_version.rb +++ b/generated/google-apis-cloudresourcemanager_v2beta1/lib/google/apis/cloudresourcemanager_v2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-cloudscheduler_v1/CHANGELOG.md b/generated/google-apis-cloudscheduler_v1/CHANGELOG.md index ead9a2fe6..e679cb2c7 100644 --- a/generated/google-apis-cloudscheduler_v1/CHANGELOG.md +++ b/generated/google-apis-cloudscheduler_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudscheduler_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200814 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudscheduler_v1/OVERVIEW.md b/generated/google-apis-cloudscheduler_v1/OVERVIEW.md index 345799fd6..76d2160df 100644 --- a/generated/google-apis-cloudscheduler_v1/OVERVIEW.md +++ b/generated/google-apis-cloudscheduler_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Scheduler API +# Simple REST client for version V1 of the Cloud Scheduler API This is a simple client library for version V1 of the Cloud Scheduler API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Scheduler API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudscheduler service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudscheduler service in particular.) For reference information on specific calls in the Cloud Scheduler API, see the {Google::Apis::CloudschedulerV1::CloudSchedulerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudscheduler_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudscheduler_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/scheduler/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudscheduler_v1/google-apis-cloudscheduler_v1.gemspec b/generated/google-apis-cloudscheduler_v1/google-apis-cloudscheduler_v1.gemspec index ba72bd32a..ef5ffcbdb 100644 --- a/generated/google-apis-cloudscheduler_v1/google-apis-cloudscheduler_v1.gemspec +++ b/generated/google-apis-cloudscheduler_v1/google-apis-cloudscheduler_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudschedulerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Scheduler API V1" + gem.summary = "Simple REST client for Cloud Scheduler API V1" gem.description = - "This is the legacy REST client for Cloud Scheduler API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Scheduler API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudscheduler_v1/lib/google/apis/cloudscheduler_v1/gem_version.rb b/generated/google-apis-cloudscheduler_v1/lib/google/apis/cloudscheduler_v1/gem_version.rb index 0fa50ef47..f16c16d92 100644 --- a/generated/google-apis-cloudscheduler_v1/lib/google/apis/cloudscheduler_v1/gem_version.rb +++ b/generated/google-apis-cloudscheduler_v1/lib/google/apis/cloudscheduler_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200814" diff --git a/generated/google-apis-cloudscheduler_v1beta1/CHANGELOG.md b/generated/google-apis-cloudscheduler_v1beta1/CHANGELOG.md index e843d4c20..3bb57a528 100644 --- a/generated/google-apis-cloudscheduler_v1beta1/CHANGELOG.md +++ b/generated/google-apis-cloudscheduler_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudscheduler_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudscheduler_v1beta1/OVERVIEW.md b/generated/google-apis-cloudscheduler_v1beta1/OVERVIEW.md index 5da8e20d3..f2436e1f5 100644 --- a/generated/google-apis-cloudscheduler_v1beta1/OVERVIEW.md +++ b/generated/google-apis-cloudscheduler_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Scheduler API +# Simple REST client for version V1beta1 of the Cloud Scheduler API This is a simple client library for version V1beta1 of the Cloud Scheduler API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Scheduler API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudscheduler service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudscheduler service in particular.) For reference information on specific calls in the Cloud Scheduler API, see the {Google::Apis::CloudschedulerV1beta1::CloudSchedulerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudscheduler_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudscheduler_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/scheduler/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudscheduler_v1beta1/google-apis-cloudscheduler_v1beta1.gemspec b/generated/google-apis-cloudscheduler_v1beta1/google-apis-cloudscheduler_v1beta1.gemspec index c822f4b13..90f6b5177 100644 --- a/generated/google-apis-cloudscheduler_v1beta1/google-apis-cloudscheduler_v1beta1.gemspec +++ b/generated/google-apis-cloudscheduler_v1beta1/google-apis-cloudscheduler_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudschedulerV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Scheduler API V1beta1" + gem.summary = "Simple REST client for Cloud Scheduler API V1beta1" gem.description = - "This is the legacy REST client for Cloud Scheduler API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Scheduler API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudscheduler_v1beta1/lib/google/apis/cloudscheduler_v1beta1/gem_version.rb b/generated/google-apis-cloudscheduler_v1beta1/lib/google/apis/cloudscheduler_v1beta1/gem_version.rb index a571f5835..9a99c7520 100644 --- a/generated/google-apis-cloudscheduler_v1beta1/lib/google/apis/cloudscheduler_v1beta1/gem_version.rb +++ b/generated/google-apis-cloudscheduler_v1beta1/lib/google/apis/cloudscheduler_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-cloudsearch_v1/CHANGELOG.md b/generated/google-apis-cloudsearch_v1/CHANGELOG.md index ce644bec6..911bcf289 100644 --- a/generated/google-apis-cloudsearch_v1/CHANGELOG.md +++ b/generated/google-apis-cloudsearch_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudsearch_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201110 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudsearch_v1/OVERVIEW.md b/generated/google-apis-cloudsearch_v1/OVERVIEW.md index 90f1d1c66..93cae614e 100644 --- a/generated/google-apis-cloudsearch_v1/OVERVIEW.md +++ b/generated/google-apis-cloudsearch_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Search API +# Simple REST client for version V1 of the Cloud Search API This is a simple client library for version V1 of the Cloud Search API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Search API. It provi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudsearch service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudsearch service in particular.) For reference information on specific calls in the Cloud Search API, see the {Google::Apis::CloudsearchV1::CloudSearchService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudsearch_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudsearch_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/cloud-search/docs/guides/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudsearch_v1/google-apis-cloudsearch_v1.gemspec b/generated/google-apis-cloudsearch_v1/google-apis-cloudsearch_v1.gemspec index ce1068926..82147ffb8 100644 --- a/generated/google-apis-cloudsearch_v1/google-apis-cloudsearch_v1.gemspec +++ b/generated/google-apis-cloudsearch_v1/google-apis-cloudsearch_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudsearchV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Search API V1" + gem.summary = "Simple REST client for Cloud Search API V1" gem.description = - "This is the legacy REST client for Cloud Search API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Search API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudsearch_v1/lib/google/apis/cloudsearch_v1/gem_version.rb b/generated/google-apis-cloudsearch_v1/lib/google/apis/cloudsearch_v1/gem_version.rb index 1204d799d..dfafd8920 100644 --- a/generated/google-apis-cloudsearch_v1/lib/google/apis/cloudsearch_v1/gem_version.rb +++ b/generated/google-apis-cloudsearch_v1/lib/google/apis/cloudsearch_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201110" diff --git a/generated/google-apis-cloudshell_v1/CHANGELOG.md b/generated/google-apis-cloudshell_v1/CHANGELOG.md index 7e52ab431..ae95f11a1 100644 --- a/generated/google-apis-cloudshell_v1/CHANGELOG.md +++ b/generated/google-apis-cloudshell_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudshell_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201003 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudshell_v1/OVERVIEW.md b/generated/google-apis-cloudshell_v1/OVERVIEW.md index 73b31773d..5926b5ab8 100644 --- a/generated/google-apis-cloudshell_v1/OVERVIEW.md +++ b/generated/google-apis-cloudshell_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Shell API +# Simple REST client for version V1 of the Cloud Shell API This is a simple client library for version V1 of the Cloud Shell API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Shell API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudshell service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudshell service in particular.) For reference information on specific calls in the Cloud Shell API, see the {Google::Apis::CloudshellV1::CloudShellService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudshell_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudshell_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/shell/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudshell_v1/google-apis-cloudshell_v1.gemspec b/generated/google-apis-cloudshell_v1/google-apis-cloudshell_v1.gemspec index 5a9f538ea..0e8fa6748 100644 --- a/generated/google-apis-cloudshell_v1/google-apis-cloudshell_v1.gemspec +++ b/generated/google-apis-cloudshell_v1/google-apis-cloudshell_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudshellV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Shell API V1" + gem.summary = "Simple REST client for Cloud Shell API V1" gem.description = - "This is the legacy REST client for Cloud Shell API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Shell API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudshell_v1/lib/google/apis/cloudshell_v1/gem_version.rb b/generated/google-apis-cloudshell_v1/lib/google/apis/cloudshell_v1/gem_version.rb index 8b0392007..2422932f5 100644 --- a/generated/google-apis-cloudshell_v1/lib/google/apis/cloudshell_v1/gem_version.rb +++ b/generated/google-apis-cloudshell_v1/lib/google/apis/cloudshell_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201003" diff --git a/generated/google-apis-cloudshell_v1alpha1/CHANGELOG.md b/generated/google-apis-cloudshell_v1alpha1/CHANGELOG.md index d641f92e4..59498340f 100644 --- a/generated/google-apis-cloudshell_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-cloudshell_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudshell_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudshell_v1alpha1/OVERVIEW.md b/generated/google-apis-cloudshell_v1alpha1/OVERVIEW.md index 56365209c..9a516034e 100644 --- a/generated/google-apis-cloudshell_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-cloudshell_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Cloud Shell API +# Simple REST client for version V1alpha1 of the Cloud Shell API This is a simple client library for version V1alpha1 of the Cloud Shell API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Cloud Shell API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudshell service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudshell service in particular.) For reference information on specific calls in the Cloud Shell API, see the {Google::Apis::CloudshellV1alpha1::CloudShellService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudshell_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudshell_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/shell/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudshell_v1alpha1/google-apis-cloudshell_v1alpha1.gemspec b/generated/google-apis-cloudshell_v1alpha1/google-apis-cloudshell_v1alpha1.gemspec index 985ee6053..331e47c23 100644 --- a/generated/google-apis-cloudshell_v1alpha1/google-apis-cloudshell_v1alpha1.gemspec +++ b/generated/google-apis-cloudshell_v1alpha1/google-apis-cloudshell_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudshellV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Shell API V1alpha1" + gem.summary = "Simple REST client for Cloud Shell API V1alpha1" gem.description = - "This is the legacy REST client for Cloud Shell API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Shell API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudshell_v1alpha1/lib/google/apis/cloudshell_v1alpha1/gem_version.rb b/generated/google-apis-cloudshell_v1alpha1/lib/google/apis/cloudshell_v1alpha1/gem_version.rb index 977986d56..b489d30b8 100644 --- a/generated/google-apis-cloudshell_v1alpha1/lib/google/apis/cloudshell_v1alpha1/gem_version.rb +++ b/generated/google-apis-cloudshell_v1alpha1/lib/google/apis/cloudshell_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-cloudtasks_v2/CHANGELOG.md b/generated/google-apis-cloudtasks_v2/CHANGELOG.md index f3a01025c..6378d6184 100644 --- a/generated/google-apis-cloudtasks_v2/CHANGELOG.md +++ b/generated/google-apis-cloudtasks_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtasks_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201111 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtasks_v2/OVERVIEW.md b/generated/google-apis-cloudtasks_v2/OVERVIEW.md index 1ade4ef0d..1859c0edb 100644 --- a/generated/google-apis-cloudtasks_v2/OVERVIEW.md +++ b/generated/google-apis-cloudtasks_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Tasks API +# Simple REST client for version V2 of the Cloud Tasks API This is a simple client library for version V2 of the Cloud Tasks API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Tasks API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtasks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtasks service in particular.) For reference information on specific calls in the Cloud Tasks API, see the {Google::Apis::CloudtasksV2::CloudTasksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtasks_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtasks_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/tasks/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtasks_v2/google-apis-cloudtasks_v2.gemspec b/generated/google-apis-cloudtasks_v2/google-apis-cloudtasks_v2.gemspec index 45fc24fe7..544a0662a 100644 --- a/generated/google-apis-cloudtasks_v2/google-apis-cloudtasks_v2.gemspec +++ b/generated/google-apis-cloudtasks_v2/google-apis-cloudtasks_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtasksV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Tasks API V2" + gem.summary = "Simple REST client for Cloud Tasks API V2" gem.description = - "This is the legacy REST client for Cloud Tasks API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Tasks API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtasks_v2/lib/google/apis/cloudtasks_v2/gem_version.rb b/generated/google-apis-cloudtasks_v2/lib/google/apis/cloudtasks_v2/gem_version.rb index 26605654a..31f24999d 100644 --- a/generated/google-apis-cloudtasks_v2/lib/google/apis/cloudtasks_v2/gem_version.rb +++ b/generated/google-apis-cloudtasks_v2/lib/google/apis/cloudtasks_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201111" diff --git a/generated/google-apis-cloudtasks_v2beta2/CHANGELOG.md b/generated/google-apis-cloudtasks_v2beta2/CHANGELOG.md index 52eb1de65..59889a5f1 100644 --- a/generated/google-apis-cloudtasks_v2beta2/CHANGELOG.md +++ b/generated/google-apis-cloudtasks_v2beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtasks_v2beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtasks_v2beta2/OVERVIEW.md b/generated/google-apis-cloudtasks_v2beta2/OVERVIEW.md index 42fc12ee0..b049a927c 100644 --- a/generated/google-apis-cloudtasks_v2beta2/OVERVIEW.md +++ b/generated/google-apis-cloudtasks_v2beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta2 of the Cloud Tasks API +# Simple REST client for version V2beta2 of the Cloud Tasks API This is a simple client library for version V2beta2 of the Cloud Tasks API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta2 of the Cloud Tasks API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtasks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtasks service in particular.) For reference information on specific calls in the Cloud Tasks API, see the {Google::Apis::CloudtasksV2beta2::CloudTasksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtasks_v2beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtasks_v2beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/tasks/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtasks_v2beta2/google-apis-cloudtasks_v2beta2.gemspec b/generated/google-apis-cloudtasks_v2beta2/google-apis-cloudtasks_v2beta2.gemspec index 97da2ea4e..713b29a61 100644 --- a/generated/google-apis-cloudtasks_v2beta2/google-apis-cloudtasks_v2beta2.gemspec +++ b/generated/google-apis-cloudtasks_v2beta2/google-apis-cloudtasks_v2beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtasksV2beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Tasks API V2beta2" + gem.summary = "Simple REST client for Cloud Tasks API V2beta2" gem.description = - "This is the legacy REST client for Cloud Tasks API V2beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Tasks API V2beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtasks_v2beta2/lib/google/apis/cloudtasks_v2beta2/gem_version.rb b/generated/google-apis-cloudtasks_v2beta2/lib/google/apis/cloudtasks_v2beta2/gem_version.rb index 9b9a4e124..242c357d1 100644 --- a/generated/google-apis-cloudtasks_v2beta2/lib/google/apis/cloudtasks_v2beta2/gem_version.rb +++ b/generated/google-apis-cloudtasks_v2beta2/lib/google/apis/cloudtasks_v2beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md b/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md index 526d89e92..83ad1caa8 100644 --- a/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md +++ b/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtasks_v2beta3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtasks_v2beta3/OVERVIEW.md b/generated/google-apis-cloudtasks_v2beta3/OVERVIEW.md index 82db82031..d4fd7943b 100644 --- a/generated/google-apis-cloudtasks_v2beta3/OVERVIEW.md +++ b/generated/google-apis-cloudtasks_v2beta3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta3 of the Cloud Tasks API +# Simple REST client for version V2beta3 of the Cloud Tasks API This is a simple client library for version V2beta3 of the Cloud Tasks API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta3 of the Cloud Tasks API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtasks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtasks service in particular.) For reference information on specific calls in the Cloud Tasks API, see the {Google::Apis::CloudtasksV2beta3::CloudTasksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtasks_v2beta3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtasks_v2beta3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/tasks/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtasks_v2beta3/google-apis-cloudtasks_v2beta3.gemspec b/generated/google-apis-cloudtasks_v2beta3/google-apis-cloudtasks_v2beta3.gemspec index e309cb366..8cde1e3af 100644 --- a/generated/google-apis-cloudtasks_v2beta3/google-apis-cloudtasks_v2beta3.gemspec +++ b/generated/google-apis-cloudtasks_v2beta3/google-apis-cloudtasks_v2beta3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtasksV2beta3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Tasks API V2beta3" + gem.summary = "Simple REST client for Cloud Tasks API V2beta3" gem.description = - "This is the legacy REST client for Cloud Tasks API V2beta3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Tasks API V2beta3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtasks_v2beta3/lib/google/apis/cloudtasks_v2beta3/gem_version.rb b/generated/google-apis-cloudtasks_v2beta3/lib/google/apis/cloudtasks_v2beta3/gem_version.rb index 6e0fe89b9..62e9f6238 100644 --- a/generated/google-apis-cloudtasks_v2beta3/lib/google/apis/cloudtasks_v2beta3/gem_version.rb +++ b/generated/google-apis-cloudtasks_v2beta3/lib/google/apis/cloudtasks_v2beta3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-cloudtrace_v1/CHANGELOG.md b/generated/google-apis-cloudtrace_v1/CHANGELOG.md index 114e3cf97..11010b4c6 100644 --- a/generated/google-apis-cloudtrace_v1/CHANGELOG.md +++ b/generated/google-apis-cloudtrace_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtrace_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200805 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtrace_v1/OVERVIEW.md b/generated/google-apis-cloudtrace_v1/OVERVIEW.md index 9cfc604f6..bd06143e9 100644 --- a/generated/google-apis-cloudtrace_v1/OVERVIEW.md +++ b/generated/google-apis-cloudtrace_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Trace API +# Simple REST client for version V1 of the Cloud Trace API This is a simple client library for version V1 of the Cloud Trace API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Trace API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtrace service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtrace service in particular.) For reference information on specific calls in the Cloud Trace API, see the {Google::Apis::CloudtraceV1::CloudTraceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtrace_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtrace_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/trace) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtrace_v1/google-apis-cloudtrace_v1.gemspec b/generated/google-apis-cloudtrace_v1/google-apis-cloudtrace_v1.gemspec index 7dd41607a..62ac3025e 100644 --- a/generated/google-apis-cloudtrace_v1/google-apis-cloudtrace_v1.gemspec +++ b/generated/google-apis-cloudtrace_v1/google-apis-cloudtrace_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtraceV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Trace API V1" + gem.summary = "Simple REST client for Cloud Trace API V1" gem.description = - "This is the legacy REST client for Cloud Trace API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Trace API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtrace_v1/lib/google/apis/cloudtrace_v1/gem_version.rb b/generated/google-apis-cloudtrace_v1/lib/google/apis/cloudtrace_v1/gem_version.rb index 05edf9cb9..b98a3cec0 100644 --- a/generated/google-apis-cloudtrace_v1/lib/google/apis/cloudtrace_v1/gem_version.rb +++ b/generated/google-apis-cloudtrace_v1/lib/google/apis/cloudtrace_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200805" diff --git a/generated/google-apis-cloudtrace_v2/CHANGELOG.md b/generated/google-apis-cloudtrace_v2/CHANGELOG.md index 4df85348a..ecc5b8c89 100644 --- a/generated/google-apis-cloudtrace_v2/CHANGELOG.md +++ b/generated/google-apis-cloudtrace_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtrace_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200805 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtrace_v2/OVERVIEW.md b/generated/google-apis-cloudtrace_v2/OVERVIEW.md index 83cfd0dfe..3526ebd43 100644 --- a/generated/google-apis-cloudtrace_v2/OVERVIEW.md +++ b/generated/google-apis-cloudtrace_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Trace API +# Simple REST client for version V2 of the Cloud Trace API This is a simple client library for version V2 of the Cloud Trace API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Trace API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtrace service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtrace service in particular.) For reference information on specific calls in the Cloud Trace API, see the {Google::Apis::CloudtraceV2::CloudTraceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtrace_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtrace_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/trace) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtrace_v2/google-apis-cloudtrace_v2.gemspec b/generated/google-apis-cloudtrace_v2/google-apis-cloudtrace_v2.gemspec index 96064a7e9..86c779e09 100644 --- a/generated/google-apis-cloudtrace_v2/google-apis-cloudtrace_v2.gemspec +++ b/generated/google-apis-cloudtrace_v2/google-apis-cloudtrace_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtraceV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Trace API V2" + gem.summary = "Simple REST client for Cloud Trace API V2" gem.description = - "This is the legacy REST client for Cloud Trace API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Trace API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtrace_v2/lib/google/apis/cloudtrace_v2/gem_version.rb b/generated/google-apis-cloudtrace_v2/lib/google/apis/cloudtrace_v2/gem_version.rb index c7d3d10e5..8e2826a6a 100644 --- a/generated/google-apis-cloudtrace_v2/lib/google/apis/cloudtrace_v2/gem_version.rb +++ b/generated/google-apis-cloudtrace_v2/lib/google/apis/cloudtrace_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200805" diff --git a/generated/google-apis-cloudtrace_v2beta1/CHANGELOG.md b/generated/google-apis-cloudtrace_v2beta1/CHANGELOG.md index d9e212deb..216e52d79 100644 --- a/generated/google-apis-cloudtrace_v2beta1/CHANGELOG.md +++ b/generated/google-apis-cloudtrace_v2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-cloudtrace_v2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200805 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-cloudtrace_v2beta1/OVERVIEW.md b/generated/google-apis-cloudtrace_v2beta1/OVERVIEW.md index 0aee921cd..1fa3e4023 100644 --- a/generated/google-apis-cloudtrace_v2beta1/OVERVIEW.md +++ b/generated/google-apis-cloudtrace_v2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta1 of the Cloud Trace API +# Simple REST client for version V2beta1 of the Cloud Trace API This is a simple client library for version V2beta1 of the Cloud Trace API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta1 of the Cloud Trace API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Cloudtrace service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Cloudtrace service in particular.) For reference information on specific calls in the Cloud Trace API, see the {Google::Apis::CloudtraceV2beta1::CloudTraceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-cloudtrace_v2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-cloudtrace_v2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/trace) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-cloudtrace_v2beta1/google-apis-cloudtrace_v2beta1.gemspec b/generated/google-apis-cloudtrace_v2beta1/google-apis-cloudtrace_v2beta1.gemspec index c1a44cb38..e67714a6e 100644 --- a/generated/google-apis-cloudtrace_v2beta1/google-apis-cloudtrace_v2beta1.gemspec +++ b/generated/google-apis-cloudtrace_v2beta1/google-apis-cloudtrace_v2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CloudtraceV2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Trace API V2beta1" + gem.summary = "Simple REST client for Cloud Trace API V2beta1" gem.description = - "This is the legacy REST client for Cloud Trace API V2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Trace API V2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-cloudtrace_v2beta1/lib/google/apis/cloudtrace_v2beta1/gem_version.rb b/generated/google-apis-cloudtrace_v2beta1/lib/google/apis/cloudtrace_v2beta1/gem_version.rb index 21591530c..989561423 100644 --- a/generated/google-apis-cloudtrace_v2beta1/lib/google/apis/cloudtrace_v2beta1/gem_version.rb +++ b/generated/google-apis-cloudtrace_v2beta1/lib/google/apis/cloudtrace_v2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200805" diff --git a/generated/google-apis-composer_v1/CHANGELOG.md b/generated/google-apis-composer_v1/CHANGELOG.md index 996cae8d6..d0b27eff2 100644 --- a/generated/google-apis-composer_v1/CHANGELOG.md +++ b/generated/google-apis-composer_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-composer_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-composer_v1/OVERVIEW.md b/generated/google-apis-composer_v1/OVERVIEW.md index c83abd5e5..2940d5a9c 100644 --- a/generated/google-apis-composer_v1/OVERVIEW.md +++ b/generated/google-apis-composer_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Composer API +# Simple REST client for version V1 of the Cloud Composer API This is a simple client library for version V1 of the Cloud Composer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Composer API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Composer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Composer service in particular.) For reference information on specific calls in the Cloud Composer API, see the {Google::Apis::ComposerV1::CloudComposerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-composer_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-composer_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/composer/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-composer_v1/google-apis-composer_v1.gemspec b/generated/google-apis-composer_v1/google-apis-composer_v1.gemspec index c22d7640d..a1b617457 100644 --- a/generated/google-apis-composer_v1/google-apis-composer_v1.gemspec +++ b/generated/google-apis-composer_v1/google-apis-composer_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ComposerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Composer API V1" + gem.summary = "Simple REST client for Cloud Composer API V1" gem.description = - "This is the legacy REST client for Cloud Composer API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Composer API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-composer_v1/lib/google/apis/composer_v1/gem_version.rb b/generated/google-apis-composer_v1/lib/google/apis/composer_v1/gem_version.rb index 3fbd819ac..cd246846d 100644 --- a/generated/google-apis-composer_v1/lib/google/apis/composer_v1/gem_version.rb +++ b/generated/google-apis-composer_v1/lib/google/apis/composer_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-composer_v1beta1/CHANGELOG.md b/generated/google-apis-composer_v1beta1/CHANGELOG.md index f5b87ca3e..0dd630bce 100644 --- a/generated/google-apis-composer_v1beta1/CHANGELOG.md +++ b/generated/google-apis-composer_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-composer_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-composer_v1beta1/OVERVIEW.md b/generated/google-apis-composer_v1beta1/OVERVIEW.md index 0a104a95f..ace0e2a8a 100644 --- a/generated/google-apis-composer_v1beta1/OVERVIEW.md +++ b/generated/google-apis-composer_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Composer API +# Simple REST client for version V1beta1 of the Cloud Composer API This is a simple client library for version V1beta1 of the Cloud Composer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Composer API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Composer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Composer service in particular.) For reference information on specific calls in the Cloud Composer API, see the {Google::Apis::ComposerV1beta1::CloudComposerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-composer_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-composer_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/composer/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-composer_v1beta1/google-apis-composer_v1beta1.gemspec b/generated/google-apis-composer_v1beta1/google-apis-composer_v1beta1.gemspec index f1d673791..40268e710 100644 --- a/generated/google-apis-composer_v1beta1/google-apis-composer_v1beta1.gemspec +++ b/generated/google-apis-composer_v1beta1/google-apis-composer_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ComposerV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Composer API V1beta1" + gem.summary = "Simple REST client for Cloud Composer API V1beta1" gem.description = - "This is the legacy REST client for Cloud Composer API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Composer API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-composer_v1beta1/lib/google/apis/composer_v1beta1/gem_version.rb b/generated/google-apis-composer_v1beta1/lib/google/apis/composer_v1beta1/gem_version.rb index 9f9e0f9a2..3c1e4a955 100644 --- a/generated/google-apis-composer_v1beta1/lib/google/apis/composer_v1beta1/gem_version.rb +++ b/generated/google-apis-composer_v1beta1/lib/google/apis/composer_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-compute_alpha/CHANGELOG.md b/generated/google-apis-compute_alpha/CHANGELOG.md index e0714ae67..ff71f4b18 100644 --- a/generated/google-apis-compute_alpha/CHANGELOG.md +++ b/generated/google-apis-compute_alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-compute_alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201122 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-compute_alpha/OVERVIEW.md b/generated/google-apis-compute_alpha/OVERVIEW.md index 94d0f2853..7156e4e31 100644 --- a/generated/google-apis-compute_alpha/OVERVIEW.md +++ b/generated/google-apis-compute_alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version Alpha of the Compute Engine API +# Simple REST client for version Alpha of the Compute Engine API This is a simple client library for version Alpha of the Compute Engine API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version Alpha of the Compute Engine API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Compute service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Compute service in particular.) For reference information on specific calls in the Compute Engine API, see the {Google::Apis::ComputeAlpha::ComputeService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-compute_alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-compute_alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/compute/docs/reference/latest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-compute_alpha/google-apis-compute_alpha.gemspec b/generated/google-apis-compute_alpha/google-apis-compute_alpha.gemspec index 60ad88287..b38588dd1 100644 --- a/generated/google-apis-compute_alpha/google-apis-compute_alpha.gemspec +++ b/generated/google-apis-compute_alpha/google-apis-compute_alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ComputeAlpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Compute Engine API Alpha" + gem.summary = "Simple REST client for Compute Engine API Alpha" gem.description = - "This is the legacy REST client for Compute Engine API Alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Compute Engine API Alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-compute_alpha/lib/google/apis/compute_alpha/gem_version.rb b/generated/google-apis-compute_alpha/lib/google/apis/compute_alpha/gem_version.rb index 38fa05801..9c3e6a723 100644 --- a/generated/google-apis-compute_alpha/lib/google/apis/compute_alpha/gem_version.rb +++ b/generated/google-apis-compute_alpha/lib/google/apis/compute_alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201122" diff --git a/generated/google-apis-compute_beta/CHANGELOG.md b/generated/google-apis-compute_beta/CHANGELOG.md index f388938bc..58b72284b 100644 --- a/generated/google-apis-compute_beta/CHANGELOG.md +++ b/generated/google-apis-compute_beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-compute_beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201122 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-compute_beta/OVERVIEW.md b/generated/google-apis-compute_beta/OVERVIEW.md index e403c9a5f..458689b9a 100644 --- a/generated/google-apis-compute_beta/OVERVIEW.md +++ b/generated/google-apis-compute_beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version Beta of the Compute Engine API +# Simple REST client for version Beta of the Compute Engine API This is a simple client library for version Beta of the Compute Engine API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version Beta of the Compute Engine API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Compute service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Compute service in particular.) For reference information on specific calls in the Compute Engine API, see the {Google::Apis::ComputeBeta::ComputeService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-compute_beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-compute_beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/compute/docs/reference/latest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-compute_beta/google-apis-compute_beta.gemspec b/generated/google-apis-compute_beta/google-apis-compute_beta.gemspec index 3a68739db..ee1fef44b 100644 --- a/generated/google-apis-compute_beta/google-apis-compute_beta.gemspec +++ b/generated/google-apis-compute_beta/google-apis-compute_beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ComputeBeta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Compute Engine API Beta" + gem.summary = "Simple REST client for Compute Engine API Beta" gem.description = - "This is the legacy REST client for Compute Engine API Beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Compute Engine API Beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-compute_beta/lib/google/apis/compute_beta/gem_version.rb b/generated/google-apis-compute_beta/lib/google/apis/compute_beta/gem_version.rb index c6d8add99..b5e5f366d 100644 --- a/generated/google-apis-compute_beta/lib/google/apis/compute_beta/gem_version.rb +++ b/generated/google-apis-compute_beta/lib/google/apis/compute_beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201122" diff --git a/generated/google-apis-compute_v1/CHANGELOG.md b/generated/google-apis-compute_v1/CHANGELOG.md index 759d9a00e..14cddcdc1 100644 --- a/generated/google-apis-compute_v1/CHANGELOG.md +++ b/generated/google-apis-compute_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-compute_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201122 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-compute_v1/OVERVIEW.md b/generated/google-apis-compute_v1/OVERVIEW.md index ed39ae9ad..39c3a1ebb 100644 --- a/generated/google-apis-compute_v1/OVERVIEW.md +++ b/generated/google-apis-compute_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Compute Engine API +# Simple REST client for version V1 of the Compute Engine API This is a simple client library for version V1 of the Compute Engine API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Compute Engine API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Compute service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Compute service in particular.) For reference information on specific calls in the Compute Engine API, see the {Google::Apis::ComputeV1::ComputeService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-compute_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-compute_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/compute/docs/reference/latest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-compute_v1/google-apis-compute_v1.gemspec b/generated/google-apis-compute_v1/google-apis-compute_v1.gemspec index 3aaa3cf2b..fdbcfc10b 100644 --- a/generated/google-apis-compute_v1/google-apis-compute_v1.gemspec +++ b/generated/google-apis-compute_v1/google-apis-compute_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ComputeV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Compute Engine API V1" + gem.summary = "Simple REST client for Compute Engine API V1" gem.description = - "This is the legacy REST client for Compute Engine API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Compute Engine API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-compute_v1/lib/google/apis/compute_v1/gem_version.rb b/generated/google-apis-compute_v1/lib/google/apis/compute_v1/gem_version.rb index 164a932a0..28e0b59ac 100644 --- a/generated/google-apis-compute_v1/lib/google/apis/compute_v1/gem_version.rb +++ b/generated/google-apis-compute_v1/lib/google/apis/compute_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201122" diff --git a/generated/google-apis-container_v1/CHANGELOG.md b/generated/google-apis-container_v1/CHANGELOG.md index 0dc2afcc8..2c0e5b3c5 100644 --- a/generated/google-apis-container_v1/CHANGELOG.md +++ b/generated/google-apis-container_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-container_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201209 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-container_v1/OVERVIEW.md b/generated/google-apis-container_v1/OVERVIEW.md index 61b81a35f..b551777ff 100644 --- a/generated/google-apis-container_v1/OVERVIEW.md +++ b/generated/google-apis-container_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Kubernetes Engine API +# Simple REST client for version V1 of the Kubernetes Engine API This is a simple client library for version V1 of the Kubernetes Engine API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Kubernetes Engine API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Container service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Container service in particular.) For reference information on specific calls in the Kubernetes Engine API, see the {Google::Apis::ContainerV1::ContainerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-container_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-container_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/container-engine/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-container_v1/google-apis-container_v1.gemspec b/generated/google-apis-container_v1/google-apis-container_v1.gemspec index 68712caa3..4b3a40ece 100644 --- a/generated/google-apis-container_v1/google-apis-container_v1.gemspec +++ b/generated/google-apis-container_v1/google-apis-container_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContainerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Kubernetes Engine API V1" + gem.summary = "Simple REST client for Kubernetes Engine API V1" gem.description = - "This is the legacy REST client for Kubernetes Engine API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Kubernetes Engine API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-container_v1/lib/google/apis/container_v1/gem_version.rb b/generated/google-apis-container_v1/lib/google/apis/container_v1/gem_version.rb index 489124bc0..09f10881b 100644 --- a/generated/google-apis-container_v1/lib/google/apis/container_v1/gem_version.rb +++ b/generated/google-apis-container_v1/lib/google/apis/container_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201209" diff --git a/generated/google-apis-container_v1beta1/CHANGELOG.md b/generated/google-apis-container_v1beta1/CHANGELOG.md index e218fef4a..112e55815 100644 --- a/generated/google-apis-container_v1beta1/CHANGELOG.md +++ b/generated/google-apis-container_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-container_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201209 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-container_v1beta1/OVERVIEW.md b/generated/google-apis-container_v1beta1/OVERVIEW.md index 42c0d2d74..3f7699a10 100644 --- a/generated/google-apis-container_v1beta1/OVERVIEW.md +++ b/generated/google-apis-container_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Kubernetes Engine API +# Simple REST client for version V1beta1 of the Kubernetes Engine API This is a simple client library for version V1beta1 of the Kubernetes Engine API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Kubernetes Engine API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Container service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Container service in particular.) For reference information on specific calls in the Kubernetes Engine API, see the {Google::Apis::ContainerV1beta1::ContainerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-container_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-container_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/container-engine/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-container_v1beta1/google-apis-container_v1beta1.gemspec b/generated/google-apis-container_v1beta1/google-apis-container_v1beta1.gemspec index 2a336578b..7b0981c44 100644 --- a/generated/google-apis-container_v1beta1/google-apis-container_v1beta1.gemspec +++ b/generated/google-apis-container_v1beta1/google-apis-container_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContainerV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Kubernetes Engine API V1beta1" + gem.summary = "Simple REST client for Kubernetes Engine API V1beta1" gem.description = - "This is the legacy REST client for Kubernetes Engine API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Kubernetes Engine API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-container_v1beta1/lib/google/apis/container_v1beta1/gem_version.rb b/generated/google-apis-container_v1beta1/lib/google/apis/container_v1beta1/gem_version.rb index 80eb05693..bcac5aeee 100644 --- a/generated/google-apis-container_v1beta1/lib/google/apis/container_v1beta1/gem_version.rb +++ b/generated/google-apis-container_v1beta1/lib/google/apis/container_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201209" diff --git a/generated/google-apis-containeranalysis_v1alpha1/CHANGELOG.md b/generated/google-apis-containeranalysis_v1alpha1/CHANGELOG.md index 2e2c0ca56..80f56ed80 100644 --- a/generated/google-apis-containeranalysis_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-containeranalysis_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-containeranalysis_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-containeranalysis_v1alpha1/OVERVIEW.md b/generated/google-apis-containeranalysis_v1alpha1/OVERVIEW.md index aed256d5d..656bd16ef 100644 --- a/generated/google-apis-containeranalysis_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-containeranalysis_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Container Analysis API +# Simple REST client for version V1alpha1 of the Container Analysis API This is a simple client library for version V1alpha1 of the Container Analysis API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Container Analysis A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Containeranalysis service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Containeranalysis service in particular.) For reference information on specific calls in the Container Analysis API, see the {Google::Apis::ContaineranalysisV1alpha1::ContainerAnalysisService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-containeranalysis_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-containeranalysis_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/container-analysis/api/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-containeranalysis_v1alpha1/google-apis-containeranalysis_v1alpha1.gemspec b/generated/google-apis-containeranalysis_v1alpha1/google-apis-containeranalysis_v1alpha1.gemspec index e047d0774..74f9e92d5 100644 --- a/generated/google-apis-containeranalysis_v1alpha1/google-apis-containeranalysis_v1alpha1.gemspec +++ b/generated/google-apis-containeranalysis_v1alpha1/google-apis-containeranalysis_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContaineranalysisV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Container Analysis API V1alpha1" + gem.summary = "Simple REST client for Container Analysis API V1alpha1" gem.description = - "This is the legacy REST client for Container Analysis API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Container Analysis API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-containeranalysis_v1alpha1/lib/google/apis/containeranalysis_v1alpha1/gem_version.rb b/generated/google-apis-containeranalysis_v1alpha1/lib/google/apis/containeranalysis_v1alpha1/gem_version.rb index 33abcb1ab..beaf7b222 100644 --- a/generated/google-apis-containeranalysis_v1alpha1/lib/google/apis/containeranalysis_v1alpha1/gem_version.rb +++ b/generated/google-apis-containeranalysis_v1alpha1/lib/google/apis/containeranalysis_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-containeranalysis_v1beta1/CHANGELOG.md b/generated/google-apis-containeranalysis_v1beta1/CHANGELOG.md index 6a53fdcdf..fc906ef37 100644 --- a/generated/google-apis-containeranalysis_v1beta1/CHANGELOG.md +++ b/generated/google-apis-containeranalysis_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-containeranalysis_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-containeranalysis_v1beta1/OVERVIEW.md b/generated/google-apis-containeranalysis_v1beta1/OVERVIEW.md index d96a1a0cb..0f332e42f 100644 --- a/generated/google-apis-containeranalysis_v1beta1/OVERVIEW.md +++ b/generated/google-apis-containeranalysis_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Container Analysis API +# Simple REST client for version V1beta1 of the Container Analysis API This is a simple client library for version V1beta1 of the Container Analysis API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Container Analysis AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Containeranalysis service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Containeranalysis service in particular.) For reference information on specific calls in the Container Analysis API, see the {Google::Apis::ContaineranalysisV1beta1::ContainerAnalysisService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-containeranalysis_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-containeranalysis_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/container-analysis/api/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-containeranalysis_v1beta1/google-apis-containeranalysis_v1beta1.gemspec b/generated/google-apis-containeranalysis_v1beta1/google-apis-containeranalysis_v1beta1.gemspec index ab424e60e..4ec35bb5a 100644 --- a/generated/google-apis-containeranalysis_v1beta1/google-apis-containeranalysis_v1beta1.gemspec +++ b/generated/google-apis-containeranalysis_v1beta1/google-apis-containeranalysis_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContaineranalysisV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Container Analysis API V1beta1" + gem.summary = "Simple REST client for Container Analysis API V1beta1" gem.description = - "This is the legacy REST client for Container Analysis API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Container Analysis API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-containeranalysis_v1beta1/lib/google/apis/containeranalysis_v1beta1/gem_version.rb b/generated/google-apis-containeranalysis_v1beta1/lib/google/apis/containeranalysis_v1beta1/gem_version.rb index b0eddf6a5..ce775fbb4 100644 --- a/generated/google-apis-containeranalysis_v1beta1/lib/google/apis/containeranalysis_v1beta1/gem_version.rb +++ b/generated/google-apis-containeranalysis_v1beta1/lib/google/apis/containeranalysis_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-content_v2/CHANGELOG.md b/generated/google-apis-content_v2/CHANGELOG.md index bbbdb4183..6b9e90342 100644 --- a/generated/google-apis-content_v2/CHANGELOG.md +++ b/generated/google-apis-content_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-content_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-content_v2/OVERVIEW.md b/generated/google-apis-content_v2/OVERVIEW.md index c4cbc7ce3..db0823371 100644 --- a/generated/google-apis-content_v2/OVERVIEW.md +++ b/generated/google-apis-content_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Content API for Shopping +# Simple REST client for version V2 of the Content API for Shopping This is a simple client library for version V2 of the Content API for Shopping. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Content API for Shopping. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Content service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Content service in particular.) For reference information on specific calls in the Content API for Shopping, see the {Google::Apis::ContentV2::ShoppingContentService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-content_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-content_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/shopping-content/v2/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-content_v2/google-apis-content_v2.gemspec b/generated/google-apis-content_v2/google-apis-content_v2.gemspec index 230cf395a..dc841a558 100644 --- a/generated/google-apis-content_v2/google-apis-content_v2.gemspec +++ b/generated/google-apis-content_v2/google-apis-content_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContentV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Content API for Shopping V2" + gem.summary = "Simple REST client for Content API for Shopping V2" gem.description = - "This is the legacy REST client for Content API for Shopping V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Content API for Shopping V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-content_v2/lib/google/apis/content_v2/gem_version.rb b/generated/google-apis-content_v2/lib/google/apis/content_v2/gem_version.rb index a41571f42..94e2efb85 100644 --- a/generated/google-apis-content_v2/lib/google/apis/content_v2/gem_version.rb +++ b/generated/google-apis-content_v2/lib/google/apis/content_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-content_v2_1/CHANGELOG.md b/generated/google-apis-content_v2_1/CHANGELOG.md index 1d367ce7a..889d75230 100644 --- a/generated/google-apis-content_v2_1/CHANGELOG.md +++ b/generated/google-apis-content_v2_1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-content_v2_1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-content_v2_1/OVERVIEW.md b/generated/google-apis-content_v2_1/OVERVIEW.md index 3f459ba74..500c975d1 100644 --- a/generated/google-apis-content_v2_1/OVERVIEW.md +++ b/generated/google-apis-content_v2_1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2_1 of the Content API for Shopping +# Simple REST client for version V2_1 of the Content API for Shopping This is a simple client library for version V2_1 of the Content API for Shopping. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2_1 of the Content API for Shopping * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Content service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Content service in particular.) For reference information on specific calls in the Content API for Shopping, see the {Google::Apis::ContentV2_1::ShoppingContentService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-content_v2_1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-content_v2_1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/shopping-content/v2/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-content_v2_1/google-apis-content_v2_1.gemspec b/generated/google-apis-content_v2_1/google-apis-content_v2_1.gemspec index c6438b81a..e7e054193 100644 --- a/generated/google-apis-content_v2_1/google-apis-content_v2_1.gemspec +++ b/generated/google-apis-content_v2_1/google-apis-content_v2_1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ContentV2_1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Content API for Shopping V2_1" + gem.summary = "Simple REST client for Content API for Shopping V2_1" gem.description = - "This is the legacy REST client for Content API for Shopping V2_1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Content API for Shopping V2_1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-content_v2_1/lib/google/apis/content_v2_1/gem_version.rb b/generated/google-apis-content_v2_1/lib/google/apis/content_v2_1/gem_version.rb index 3ae36b212..0238567d9 100644 --- a/generated/google-apis-content_v2_1/lib/google/apis/content_v2_1/gem_version.rb +++ b/generated/google-apis-content_v2_1/lib/google/apis/content_v2_1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-customsearch_v1/CHANGELOG.md b/generated/google-apis-customsearch_v1/CHANGELOG.md index 5e3031601..770df91d0 100644 --- a/generated/google-apis-customsearch_v1/CHANGELOG.md +++ b/generated/google-apis-customsearch_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-customsearch_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200917 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-customsearch_v1/OVERVIEW.md b/generated/google-apis-customsearch_v1/OVERVIEW.md index 01428dbc2..320d9f5af 100644 --- a/generated/google-apis-customsearch_v1/OVERVIEW.md +++ b/generated/google-apis-customsearch_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Custom Search API +# Simple REST client for version V1 of the Custom Search API This is a simple client library for version V1 of the Custom Search API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Custom Search API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Customsearch service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Customsearch service in particular.) For reference information on specific calls in the Custom Search API, see the {Google::Apis::CustomsearchV1::CustomSearchAPIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-customsearch_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-customsearch_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/custom-search/v1/introduction) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-customsearch_v1/google-apis-customsearch_v1.gemspec b/generated/google-apis-customsearch_v1/google-apis-customsearch_v1.gemspec index fb20b0d30..84ffafabf 100644 --- a/generated/google-apis-customsearch_v1/google-apis-customsearch_v1.gemspec +++ b/generated/google-apis-customsearch_v1/google-apis-customsearch_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::CustomsearchV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Custom Search API V1" + gem.summary = "Simple REST client for Custom Search API V1" gem.description = - "This is the legacy REST client for Custom Search API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Custom Search API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-customsearch_v1/lib/google/apis/customsearch_v1/gem_version.rb b/generated/google-apis-customsearch_v1/lib/google/apis/customsearch_v1/gem_version.rb index 230743f60..96174298a 100644 --- a/generated/google-apis-customsearch_v1/lib/google/apis/customsearch_v1/gem_version.rb +++ b/generated/google-apis-customsearch_v1/lib/google/apis/customsearch_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200917" diff --git a/generated/google-apis-datacatalog_v1beta1/CHANGELOG.md b/generated/google-apis-datacatalog_v1beta1/CHANGELOG.md index 757400326..0e82f8c69 100644 --- a/generated/google-apis-datacatalog_v1beta1/CHANGELOG.md +++ b/generated/google-apis-datacatalog_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datacatalog_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201210 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datacatalog_v1beta1/OVERVIEW.md b/generated/google-apis-datacatalog_v1beta1/OVERVIEW.md index 95c083807..aca635d54 100644 --- a/generated/google-apis-datacatalog_v1beta1/OVERVIEW.md +++ b/generated/google-apis-datacatalog_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Google Cloud Data Catalog API +# Simple REST client for version V1beta1 of the Google Cloud Data Catalog API This is a simple client library for version V1beta1 of the Google Cloud Data Catalog API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Google Cloud Data Cat * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datacatalog service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datacatalog service in particular.) For reference information on specific calls in the Google Cloud Data Catalog API, see the {Google::Apis::DatacatalogV1beta1::DataCatalogService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datacatalog_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datacatalog_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/data-catalog/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datacatalog_v1beta1/google-apis-datacatalog_v1beta1.gemspec b/generated/google-apis-datacatalog_v1beta1/google-apis-datacatalog_v1beta1.gemspec index cb91cfef9..9b3ee6b17 100644 --- a/generated/google-apis-datacatalog_v1beta1/google-apis-datacatalog_v1beta1.gemspec +++ b/generated/google-apis-datacatalog_v1beta1/google-apis-datacatalog_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatacatalogV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Cloud Data Catalog API V1beta1" + gem.summary = "Simple REST client for Google Cloud Data Catalog API V1beta1" gem.description = - "This is the legacy REST client for Google Cloud Data Catalog API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Cloud Data Catalog API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datacatalog_v1beta1/lib/google/apis/datacatalog_v1beta1/gem_version.rb b/generated/google-apis-datacatalog_v1beta1/lib/google/apis/datacatalog_v1beta1/gem_version.rb index 42f623367..c4b277fb6 100644 --- a/generated/google-apis-datacatalog_v1beta1/lib/google/apis/datacatalog_v1beta1/gem_version.rb +++ b/generated/google-apis-datacatalog_v1beta1/lib/google/apis/datacatalog_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201210" diff --git a/generated/google-apis-dataflow_v1b3/CHANGELOG.md b/generated/google-apis-dataflow_v1b3/CHANGELOG.md index 455019c0a..4f13dd0ff 100644 --- a/generated/google-apis-dataflow_v1b3/CHANGELOG.md +++ b/generated/google-apis-dataflow_v1b3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-dataflow_v1b3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-dataflow_v1b3/OVERVIEW.md b/generated/google-apis-dataflow_v1b3/OVERVIEW.md index 1d278272e..eb033bb7b 100644 --- a/generated/google-apis-dataflow_v1b3/OVERVIEW.md +++ b/generated/google-apis-dataflow_v1b3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1b3 of the Dataflow API +# Simple REST client for version V1b3 of the Dataflow API This is a simple client library for version V1b3 of the Dataflow API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1b3 of the Dataflow API. It provide * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dataflow service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dataflow service in particular.) For reference information on specific calls in the Dataflow API, see the {Google::Apis::DataflowV1b3::DataflowService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dataflow_v1b3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dataflow_v1b3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dataflow) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dataflow_v1b3/google-apis-dataflow_v1b3.gemspec b/generated/google-apis-dataflow_v1b3/google-apis-dataflow_v1b3.gemspec index bbc561113..3e8f04223 100644 --- a/generated/google-apis-dataflow_v1b3/google-apis-dataflow_v1b3.gemspec +++ b/generated/google-apis-dataflow_v1b3/google-apis-dataflow_v1b3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DataflowV1b3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dataflow API V1b3" + gem.summary = "Simple REST client for Dataflow API V1b3" gem.description = - "This is the legacy REST client for Dataflow API V1b3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dataflow API V1b3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dataflow_v1b3/lib/google/apis/dataflow_v1b3/gem_version.rb b/generated/google-apis-dataflow_v1b3/lib/google/apis/dataflow_v1b3/gem_version.rb index ae5a123b0..495c090b1 100644 --- a/generated/google-apis-dataflow_v1b3/lib/google/apis/dataflow_v1b3/gem_version.rb +++ b/generated/google-apis-dataflow_v1b3/lib/google/apis/dataflow_v1b3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-datafusion_v1/CHANGELOG.md b/generated/google-apis-datafusion_v1/CHANGELOG.md index 0f5e4e4fc..eacd213d6 100644 --- a/generated/google-apis-datafusion_v1/CHANGELOG.md +++ b/generated/google-apis-datafusion_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datafusion_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200928 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datafusion_v1/OVERVIEW.md b/generated/google-apis-datafusion_v1/OVERVIEW.md index 72724f672..732459ad2 100644 --- a/generated/google-apis-datafusion_v1/OVERVIEW.md +++ b/generated/google-apis-datafusion_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Data Fusion API +# Simple REST client for version V1 of the Cloud Data Fusion API This is a simple client library for version V1 of the Cloud Data Fusion API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Data Fusion API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datafusion service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datafusion service in particular.) For reference information on specific calls in the Cloud Data Fusion API, see the {Google::Apis::DatafusionV1::DataFusionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datafusion_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datafusion_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/data-fusion/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datafusion_v1/google-apis-datafusion_v1.gemspec b/generated/google-apis-datafusion_v1/google-apis-datafusion_v1.gemspec index 8a99688c3..c895a4e82 100644 --- a/generated/google-apis-datafusion_v1/google-apis-datafusion_v1.gemspec +++ b/generated/google-apis-datafusion_v1/google-apis-datafusion_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatafusionV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Data Fusion API V1" + gem.summary = "Simple REST client for Cloud Data Fusion API V1" gem.description = - "This is the legacy REST client for Cloud Data Fusion API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Data Fusion API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datafusion_v1/lib/google/apis/datafusion_v1/gem_version.rb b/generated/google-apis-datafusion_v1/lib/google/apis/datafusion_v1/gem_version.rb index d94f95f63..9d8a61d53 100644 --- a/generated/google-apis-datafusion_v1/lib/google/apis/datafusion_v1/gem_version.rb +++ b/generated/google-apis-datafusion_v1/lib/google/apis/datafusion_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200928" diff --git a/generated/google-apis-datafusion_v1beta1/CHANGELOG.md b/generated/google-apis-datafusion_v1beta1/CHANGELOG.md index 5c0f42b1e..7d2a6937c 100644 --- a/generated/google-apis-datafusion_v1beta1/CHANGELOG.md +++ b/generated/google-apis-datafusion_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datafusion_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200901 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datafusion_v1beta1/OVERVIEW.md b/generated/google-apis-datafusion_v1beta1/OVERVIEW.md index 32128d984..621ea0f93 100644 --- a/generated/google-apis-datafusion_v1beta1/OVERVIEW.md +++ b/generated/google-apis-datafusion_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Data Fusion API +# Simple REST client for version V1beta1 of the Cloud Data Fusion API This is a simple client library for version V1beta1 of the Cloud Data Fusion API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Data Fusion API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datafusion service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datafusion service in particular.) For reference information on specific calls in the Cloud Data Fusion API, see the {Google::Apis::DatafusionV1beta1::DataFusionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datafusion_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datafusion_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/data-fusion/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datafusion_v1beta1/google-apis-datafusion_v1beta1.gemspec b/generated/google-apis-datafusion_v1beta1/google-apis-datafusion_v1beta1.gemspec index f91c61922..7a5a7ef35 100644 --- a/generated/google-apis-datafusion_v1beta1/google-apis-datafusion_v1beta1.gemspec +++ b/generated/google-apis-datafusion_v1beta1/google-apis-datafusion_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatafusionV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Data Fusion API V1beta1" + gem.summary = "Simple REST client for Cloud Data Fusion API V1beta1" gem.description = - "This is the legacy REST client for Cloud Data Fusion API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Data Fusion API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datafusion_v1beta1/lib/google/apis/datafusion_v1beta1/gem_version.rb b/generated/google-apis-datafusion_v1beta1/lib/google/apis/datafusion_v1beta1/gem_version.rb index 8bb0226ba..6fec947fb 100644 --- a/generated/google-apis-datafusion_v1beta1/lib/google/apis/datafusion_v1beta1/gem_version.rb +++ b/generated/google-apis-datafusion_v1beta1/lib/google/apis/datafusion_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200901" diff --git a/generated/google-apis-datalabeling_v1beta1/CHANGELOG.md b/generated/google-apis-datalabeling_v1beta1/CHANGELOG.md index 04fc00a67..e5d1acf2c 100644 --- a/generated/google-apis-datalabeling_v1beta1/CHANGELOG.md +++ b/generated/google-apis-datalabeling_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datalabeling_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201216 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datalabeling_v1beta1/OVERVIEW.md b/generated/google-apis-datalabeling_v1beta1/OVERVIEW.md index cf2dd3928..b6c0f290d 100644 --- a/generated/google-apis-datalabeling_v1beta1/OVERVIEW.md +++ b/generated/google-apis-datalabeling_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Data Labeling API +# Simple REST client for version V1beta1 of the Data Labeling API This is a simple client library for version V1beta1 of the Data Labeling API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Data Labeling API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datalabeling service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datalabeling service in particular.) For reference information on specific calls in the Data Labeling API, see the {Google::Apis::DatalabelingV1beta1::DataLabelingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datalabeling_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datalabeling_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/data-labeling/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datalabeling_v1beta1/google-apis-datalabeling_v1beta1.gemspec b/generated/google-apis-datalabeling_v1beta1/google-apis-datalabeling_v1beta1.gemspec index 77dfe0898..0f27cd2f4 100644 --- a/generated/google-apis-datalabeling_v1beta1/google-apis-datalabeling_v1beta1.gemspec +++ b/generated/google-apis-datalabeling_v1beta1/google-apis-datalabeling_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatalabelingV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Data Labeling API V1beta1" + gem.summary = "Simple REST client for Data Labeling API V1beta1" gem.description = - "This is the legacy REST client for Data Labeling API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Data Labeling API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datalabeling_v1beta1/lib/google/apis/datalabeling_v1beta1/gem_version.rb b/generated/google-apis-datalabeling_v1beta1/lib/google/apis/datalabeling_v1beta1/gem_version.rb index 74b3b03cb..c24c02f39 100644 --- a/generated/google-apis-datalabeling_v1beta1/lib/google/apis/datalabeling_v1beta1/gem_version.rb +++ b/generated/google-apis-datalabeling_v1beta1/lib/google/apis/datalabeling_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201216" diff --git a/generated/google-apis-datamigration_v1beta1/CHANGELOG.md b/generated/google-apis-datamigration_v1beta1/CHANGELOG.md index ea7ae7113..a3ae8a6bf 100644 --- a/generated/google-apis-datamigration_v1beta1/CHANGELOG.md +++ b/generated/google-apis-datamigration_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datamigration_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20201229 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-datamigration_v1beta1/OVERVIEW.md b/generated/google-apis-datamigration_v1beta1/OVERVIEW.md index 18cece862..338d0d57e 100644 --- a/generated/google-apis-datamigration_v1beta1/OVERVIEW.md +++ b/generated/google-apis-datamigration_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Database Migration API +# Simple REST client for version V1beta1 of the Database Migration API This is a simple client library for version V1beta1 of the Database Migration API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Database Migration AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -48,7 +48,7 @@ Once the gem is installed, you can load the client code and instantiate a client require "google/apis/datamigration_v1beta1" # Create a client object -client = Google::Apis::DatamigrationV1beta1::CloudDatabaseMigrationServiceService.new +client = Google::Apis::DatamigrationV1beta1::DatabaseMigrationServiceService.new # Authenticate calls client.authentication = # ... use the googleauth gem to create credentials @@ -58,28 +58,28 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datamigration service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datamigration service in particular.) -For reference information on specific calls in the Database Migration API, see the {Google::Apis::DatamigrationV1beta1::CloudDatabaseMigrationServiceService class reference docs}. +For reference information on specific calls in the Database Migration API, see the {Google::Apis::DatamigrationV1beta1::DatabaseMigrationServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datamigration_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datamigration_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. -The [product documentation](https://cloud.google.com/datamigration/) may provide guidance regarding the preferred client library to use. +The [product documentation](https://cloud.google.com/database-migration/) may provide guidance regarding the preferred client library to use. ## Supported Ruby versions diff --git a/generated/google-apis-datamigration_v1beta1/google-apis-datamigration_v1beta1.gemspec b/generated/google-apis-datamigration_v1beta1/google-apis-datamigration_v1beta1.gemspec index c1b404138..d9091b7f1 100644 --- a/generated/google-apis-datamigration_v1beta1/google-apis-datamigration_v1beta1.gemspec +++ b/generated/google-apis-datamigration_v1beta1/google-apis-datamigration_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatamigrationV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Database Migration API V1beta1" + gem.summary = "Simple REST client for Database Migration API V1beta1" gem.description = - "This is the legacy REST client for Database Migration API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Database Migration API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1.rb b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1.rb index ec9eb8401..09307ad89 100644 --- a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1.rb +++ b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1.rb @@ -23,7 +23,7 @@ module Google # # Manage Cloud Database Migration Service resources on Google Cloud Platform. # - # @see https://cloud.google.com/datamigration/ + # @see https://cloud.google.com/database-migration/ module DatamigrationV1beta1 # Version of the Database Migration API this client connects to. # This is NOT the gem version. diff --git a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/classes.rb b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/classes.rb index 8693e4d89..f8d6509d6 100644 --- a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/classes.rb +++ b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/classes.rb @@ -257,7 +257,7 @@ module Google # @return [Hash] attr_accessor :database_flags - # The database engine type and version (such as `MYSQL_5_7` / `POSTGRES_9_6`). + # The database engine type and version. # Corresponds to the JSON property `databaseVersion` # @return [String] attr_accessor :database_version @@ -292,9 +292,8 @@ module Google attr_accessor :storage_auto_resize_limit # The tier (or machine type) for this instance, for example: `db-n1-standard-1` ( - # MySQL instances) or `db-custom-1-3840` (PostgreSQL instances). For more - # information, see [Cloud SQL Instance Settings](https://cloud.google.com/sql/ - # docs/mysql/instance-settings). + # MySQL instances). For more information, see [Cloud SQL Instance Settings]( + # https://cloud.google.com/sql/docs/mysql/instance-settings). # Corresponds to the JSON property `tier` # @return [String] attr_accessor :tier diff --git a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/gem_version.rb b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/gem_version.rb index a91db1bed..7c3267883 100644 --- a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/gem_version.rb +++ b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201202" + REVISION = "20201229" end end end diff --git a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/service.rb b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/service.rb index 46fa34178..e03e92ae7 100644 --- a/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/service.rb +++ b/generated/google-apis-datamigration_v1beta1/lib/google/apis/datamigration_v1beta1/service.rb @@ -28,10 +28,10 @@ module Google # require 'google/apis/datamigration_v1beta1' # # Datamigration = Google::Apis::DatamigrationV1beta1 # Alias the module - # service = Datamigration::CloudDatabaseMigrationServiceService.new + # service = Datamigration::DatabaseMigrationServiceService.new # - # @see https://cloud.google.com/datamigration/ - class CloudDatabaseMigrationServiceService < Google::Apis::Core::BaseService + # @see https://cloud.google.com/database-migration/ + class DatabaseMigrationServiceService < Google::Apis::Core::BaseService # @return [String] # 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. diff --git a/generated/google-apis-datamigration_v1beta1/spec/generated_spec.rb b/generated/google-apis-datamigration_v1beta1/spec/generated_spec.rb index fe8bd289b..663452173 100644 --- a/generated/google-apis-datamigration_v1beta1/spec/generated_spec.rb +++ b/generated/google-apis-datamigration_v1beta1/spec/generated_spec.rb @@ -21,7 +21,7 @@ RSpec.describe "Google::Apis::DatamigrationV1beta1" do require "google/apis/datamigration_v1beta1" end.not_to raise_error expect do - Google::Apis::DatamigrationV1beta1::CloudDatabaseMigrationServiceService.new + Google::Apis::DatamigrationV1beta1::DatabaseMigrationServiceService.new end.not_to raise_error end end diff --git a/generated/google-apis-dataproc_v1/OVERVIEW.md b/generated/google-apis-dataproc_v1/OVERVIEW.md index 869523020..365fc9afe 100644 --- a/generated/google-apis-dataproc_v1/OVERVIEW.md +++ b/generated/google-apis-dataproc_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Dataproc API +# Simple REST client for version V1 of the Cloud Dataproc API This is a simple client library for version V1 of the Cloud Dataproc API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Dataproc API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dataproc service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dataproc service in particular.) For reference information on specific calls in the Cloud Dataproc API, see the {Google::Apis::DataprocV1::DataprocService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dataproc_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dataproc_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dataproc/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dataproc_v1/google-apis-dataproc_v1.gemspec b/generated/google-apis-dataproc_v1/google-apis-dataproc_v1.gemspec index 6b870fcae..4309c32fc 100644 --- a/generated/google-apis-dataproc_v1/google-apis-dataproc_v1.gemspec +++ b/generated/google-apis-dataproc_v1/google-apis-dataproc_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DataprocV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Dataproc API V1" + gem.summary = "Simple REST client for Cloud Dataproc API V1" gem.description = - "This is the legacy REST client for Cloud Dataproc API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Dataproc API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dataproc_v1beta2/OVERVIEW.md b/generated/google-apis-dataproc_v1beta2/OVERVIEW.md index 6e55c057a..230f8a1ff 100644 --- a/generated/google-apis-dataproc_v1beta2/OVERVIEW.md +++ b/generated/google-apis-dataproc_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Dataproc API +# Simple REST client for version V1beta2 of the Cloud Dataproc API This is a simple client library for version V1beta2 of the Cloud Dataproc API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Dataproc API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dataproc service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dataproc service in particular.) For reference information on specific calls in the Cloud Dataproc API, see the {Google::Apis::DataprocV1beta2::DataprocService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dataproc_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dataproc_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dataproc/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dataproc_v1beta2/google-apis-dataproc_v1beta2.gemspec b/generated/google-apis-dataproc_v1beta2/google-apis-dataproc_v1beta2.gemspec index 8a98f9b07..3e0a569a0 100644 --- a/generated/google-apis-dataproc_v1beta2/google-apis-dataproc_v1beta2.gemspec +++ b/generated/google-apis-dataproc_v1beta2/google-apis-dataproc_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DataprocV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Dataproc API V1beta2" + gem.summary = "Simple REST client for Cloud Dataproc API V1beta2" gem.description = - "This is the legacy REST client for Cloud Dataproc API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Dataproc API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datastore_v1/CHANGELOG.md b/generated/google-apis-datastore_v1/CHANGELOG.md index ed9b310ac..e6f30e066 100644 --- a/generated/google-apis-datastore_v1/CHANGELOG.md +++ b/generated/google-apis-datastore_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datastore_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201017 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datastore_v1/OVERVIEW.md b/generated/google-apis-datastore_v1/OVERVIEW.md index 96b9ef2cf..60bd8ba4c 100644 --- a/generated/google-apis-datastore_v1/OVERVIEW.md +++ b/generated/google-apis-datastore_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Datastore API +# Simple REST client for version V1 of the Cloud Datastore API This is a simple client library for version V1 of the Cloud Datastore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Datastore API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datastore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datastore service in particular.) For reference information on specific calls in the Cloud Datastore API, see the {Google::Apis::DatastoreV1::DatastoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datastore_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datastore_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/datastore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datastore_v1/google-apis-datastore_v1.gemspec b/generated/google-apis-datastore_v1/google-apis-datastore_v1.gemspec index 30891a623..8890f8b51 100644 --- a/generated/google-apis-datastore_v1/google-apis-datastore_v1.gemspec +++ b/generated/google-apis-datastore_v1/google-apis-datastore_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatastoreV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Datastore API V1" + gem.summary = "Simple REST client for Cloud Datastore API V1" gem.description = - "This is the legacy REST client for Cloud Datastore API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Datastore API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datastore_v1/lib/google/apis/datastore_v1/gem_version.rb b/generated/google-apis-datastore_v1/lib/google/apis/datastore_v1/gem_version.rb index f02739c28..8b06a2e97 100644 --- a/generated/google-apis-datastore_v1/lib/google/apis/datastore_v1/gem_version.rb +++ b/generated/google-apis-datastore_v1/lib/google/apis/datastore_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201017" diff --git a/generated/google-apis-datastore_v1beta1/CHANGELOG.md b/generated/google-apis-datastore_v1beta1/CHANGELOG.md index dc52d907b..55984e210 100644 --- a/generated/google-apis-datastore_v1beta1/CHANGELOG.md +++ b/generated/google-apis-datastore_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datastore_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200802 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datastore_v1beta1/OVERVIEW.md b/generated/google-apis-datastore_v1beta1/OVERVIEW.md index 567411fb3..3d8553165 100644 --- a/generated/google-apis-datastore_v1beta1/OVERVIEW.md +++ b/generated/google-apis-datastore_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Datastore API +# Simple REST client for version V1beta1 of the Cloud Datastore API This is a simple client library for version V1beta1 of the Cloud Datastore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Datastore API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datastore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datastore service in particular.) For reference information on specific calls in the Cloud Datastore API, see the {Google::Apis::DatastoreV1beta1::DatastoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datastore_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datastore_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/datastore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datastore_v1beta1/google-apis-datastore_v1beta1.gemspec b/generated/google-apis-datastore_v1beta1/google-apis-datastore_v1beta1.gemspec index cb04376d1..040c1e7c0 100644 --- a/generated/google-apis-datastore_v1beta1/google-apis-datastore_v1beta1.gemspec +++ b/generated/google-apis-datastore_v1beta1/google-apis-datastore_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatastoreV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Datastore API V1beta1" + gem.summary = "Simple REST client for Cloud Datastore API V1beta1" gem.description = - "This is the legacy REST client for Cloud Datastore API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Datastore API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datastore_v1beta1/lib/google/apis/datastore_v1beta1/gem_version.rb b/generated/google-apis-datastore_v1beta1/lib/google/apis/datastore_v1beta1/gem_version.rb index 2f4a1e48d..04b63a5e7 100644 --- a/generated/google-apis-datastore_v1beta1/lib/google/apis/datastore_v1beta1/gem_version.rb +++ b/generated/google-apis-datastore_v1beta1/lib/google/apis/datastore_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200802" diff --git a/generated/google-apis-datastore_v1beta3/CHANGELOG.md b/generated/google-apis-datastore_v1beta3/CHANGELOG.md index 1a4daf051..1a32392bd 100644 --- a/generated/google-apis-datastore_v1beta3/CHANGELOG.md +++ b/generated/google-apis-datastore_v1beta3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-datastore_v1beta3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201017 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-datastore_v1beta3/OVERVIEW.md b/generated/google-apis-datastore_v1beta3/OVERVIEW.md index 1b661ee33..aefee3a3a 100644 --- a/generated/google-apis-datastore_v1beta3/OVERVIEW.md +++ b/generated/google-apis-datastore_v1beta3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta3 of the Cloud Datastore API +# Simple REST client for version V1beta3 of the Cloud Datastore API This is a simple client library for version V1beta3 of the Cloud Datastore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta3 of the Cloud Datastore API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Datastore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datastore service in particular.) For reference information on specific calls in the Cloud Datastore API, see the {Google::Apis::DatastoreV1beta3::DatastoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-datastore_v1beta3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-datastore_v1beta3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/datastore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-datastore_v1beta3/google-apis-datastore_v1beta3.gemspec b/generated/google-apis-datastore_v1beta3/google-apis-datastore_v1beta3.gemspec index 947521fc5..a09c71b8c 100644 --- a/generated/google-apis-datastore_v1beta3/google-apis-datastore_v1beta3.gemspec +++ b/generated/google-apis-datastore_v1beta3/google-apis-datastore_v1beta3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DatastoreV1beta3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Datastore API V1beta3" + gem.summary = "Simple REST client for Cloud Datastore API V1beta3" gem.description = - "This is the legacy REST client for Cloud Datastore API V1beta3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Datastore API V1beta3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-datastore_v1beta3/lib/google/apis/datastore_v1beta3/gem_version.rb b/generated/google-apis-datastore_v1beta3/lib/google/apis/datastore_v1beta3/gem_version.rb index a0396868e..f007a61f4 100644 --- a/generated/google-apis-datastore_v1beta3/lib/google/apis/datastore_v1beta3/gem_version.rb +++ b/generated/google-apis-datastore_v1beta3/lib/google/apis/datastore_v1beta3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201017" diff --git a/generated/google-apis-deploymentmanager_alpha/CHANGELOG.md b/generated/google-apis-deploymentmanager_alpha/CHANGELOG.md index 6e18f11c1..7166929fb 100644 --- a/generated/google-apis-deploymentmanager_alpha/CHANGELOG.md +++ b/generated/google-apis-deploymentmanager_alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-deploymentmanager_alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-deploymentmanager_alpha/OVERVIEW.md b/generated/google-apis-deploymentmanager_alpha/OVERVIEW.md index 42b6503b0..26d3c917c 100644 --- a/generated/google-apis-deploymentmanager_alpha/OVERVIEW.md +++ b/generated/google-apis-deploymentmanager_alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version Alpha of the Cloud Deployment Manager V2 API +# Simple REST client for version Alpha of the Cloud Deployment Manager V2 API This is a simple client library for version Alpha of the Cloud Deployment Manager V2 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version Alpha of the Cloud Deployment Manage * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Deploymentmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Deploymentmanager service in particular.) For reference information on specific calls in the Cloud Deployment Manager V2 API, see the {Google::Apis::DeploymentmanagerAlpha::DeploymentManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-deploymentmanager_alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-deploymentmanager_alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/deployment-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-deploymentmanager_alpha/google-apis-deploymentmanager_alpha.gemspec b/generated/google-apis-deploymentmanager_alpha/google-apis-deploymentmanager_alpha.gemspec index 8682ac140..823a76b92 100644 --- a/generated/google-apis-deploymentmanager_alpha/google-apis-deploymentmanager_alpha.gemspec +++ b/generated/google-apis-deploymentmanager_alpha/google-apis-deploymentmanager_alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DeploymentmanagerAlpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Deployment Manager V2 API Alpha" + gem.summary = "Simple REST client for Cloud Deployment Manager V2 API Alpha" gem.description = - "This is the legacy REST client for Cloud Deployment Manager V2 API Alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Deployment Manager V2 API Alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-deploymentmanager_alpha/lib/google/apis/deploymentmanager_alpha/gem_version.rb b/generated/google-apis-deploymentmanager_alpha/lib/google/apis/deploymentmanager_alpha/gem_version.rb index e66af0d81..cfdb3527c 100644 --- a/generated/google-apis-deploymentmanager_alpha/lib/google/apis/deploymentmanager_alpha/gem_version.rb +++ b/generated/google-apis-deploymentmanager_alpha/lib/google/apis/deploymentmanager_alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-deploymentmanager_v2/CHANGELOG.md b/generated/google-apis-deploymentmanager_v2/CHANGELOG.md index d05d0b25b..49fe53150 100644 --- a/generated/google-apis-deploymentmanager_v2/CHANGELOG.md +++ b/generated/google-apis-deploymentmanager_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-deploymentmanager_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-deploymentmanager_v2/OVERVIEW.md b/generated/google-apis-deploymentmanager_v2/OVERVIEW.md index b6a893e8b..8f104d703 100644 --- a/generated/google-apis-deploymentmanager_v2/OVERVIEW.md +++ b/generated/google-apis-deploymentmanager_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Deployment Manager V2 API +# Simple REST client for version V2 of the Cloud Deployment Manager V2 API This is a simple client library for version V2 of the Cloud Deployment Manager V2 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Deployment Manager V * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Deploymentmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Deploymentmanager service in particular.) For reference information on specific calls in the Cloud Deployment Manager V2 API, see the {Google::Apis::DeploymentmanagerV2::DeploymentManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-deploymentmanager_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-deploymentmanager_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/deployment-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-deploymentmanager_v2/google-apis-deploymentmanager_v2.gemspec b/generated/google-apis-deploymentmanager_v2/google-apis-deploymentmanager_v2.gemspec index eb1d16cc1..cff39aa1f 100644 --- a/generated/google-apis-deploymentmanager_v2/google-apis-deploymentmanager_v2.gemspec +++ b/generated/google-apis-deploymentmanager_v2/google-apis-deploymentmanager_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DeploymentmanagerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Deployment Manager V2 API V2" + gem.summary = "Simple REST client for Cloud Deployment Manager V2 API V2" gem.description = - "This is the legacy REST client for Cloud Deployment Manager V2 API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Deployment Manager V2 API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-deploymentmanager_v2/lib/google/apis/deploymentmanager_v2/gem_version.rb b/generated/google-apis-deploymentmanager_v2/lib/google/apis/deploymentmanager_v2/gem_version.rb index 87a8aaf23..6e723b926 100644 --- a/generated/google-apis-deploymentmanager_v2/lib/google/apis/deploymentmanager_v2/gem_version.rb +++ b/generated/google-apis-deploymentmanager_v2/lib/google/apis/deploymentmanager_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-deploymentmanager_v2beta/CHANGELOG.md b/generated/google-apis-deploymentmanager_v2beta/CHANGELOG.md index 7919cfae9..93350b562 100644 --- a/generated/google-apis-deploymentmanager_v2beta/CHANGELOG.md +++ b/generated/google-apis-deploymentmanager_v2beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-deploymentmanager_v2beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-deploymentmanager_v2beta/OVERVIEW.md b/generated/google-apis-deploymentmanager_v2beta/OVERVIEW.md index 934b61bdf..11e1b1184 100644 --- a/generated/google-apis-deploymentmanager_v2beta/OVERVIEW.md +++ b/generated/google-apis-deploymentmanager_v2beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta of the Cloud Deployment Manager V2 API +# Simple REST client for version V2beta of the Cloud Deployment Manager V2 API This is a simple client library for version V2beta of the Cloud Deployment Manager V2 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta of the Cloud Deployment Manag * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Deploymentmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Deploymentmanager service in particular.) For reference information on specific calls in the Cloud Deployment Manager V2 API, see the {Google::Apis::DeploymentmanagerV2beta::DeploymentManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-deploymentmanager_v2beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-deploymentmanager_v2beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/deployment-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-deploymentmanager_v2beta/google-apis-deploymentmanager_v2beta.gemspec b/generated/google-apis-deploymentmanager_v2beta/google-apis-deploymentmanager_v2beta.gemspec index 01444f9f5..30a2da75d 100644 --- a/generated/google-apis-deploymentmanager_v2beta/google-apis-deploymentmanager_v2beta.gemspec +++ b/generated/google-apis-deploymentmanager_v2beta/google-apis-deploymentmanager_v2beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DeploymentmanagerV2beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Deployment Manager V2 API V2beta" + gem.summary = "Simple REST client for Cloud Deployment Manager V2 API V2beta" gem.description = - "This is the legacy REST client for Cloud Deployment Manager V2 API V2beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Deployment Manager V2 API V2beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-deploymentmanager_v2beta/lib/google/apis/deploymentmanager_v2beta/gem_version.rb b/generated/google-apis-deploymentmanager_v2beta/lib/google/apis/deploymentmanager_v2beta/gem_version.rb index 69a1ec44e..7900b7e44 100644 --- a/generated/google-apis-deploymentmanager_v2beta/lib/google/apis/deploymentmanager_v2beta/gem_version.rb +++ b/generated/google-apis-deploymentmanager_v2beta/lib/google/apis/deploymentmanager_v2beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-dfareporting_v3_3/CHANGELOG.md b/generated/google-apis-dfareporting_v3_3/CHANGELOG.md index a98f6e0a4..4104456eb 100644 --- a/generated/google-apis-dfareporting_v3_3/CHANGELOG.md +++ b/generated/google-apis-dfareporting_v3_3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-dfareporting_v3_3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201102 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-dfareporting_v3_3/OVERVIEW.md b/generated/google-apis-dfareporting_v3_3/OVERVIEW.md index a75b75421..1bac9f904 100644 --- a/generated/google-apis-dfareporting_v3_3/OVERVIEW.md +++ b/generated/google-apis-dfareporting_v3_3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3_3 of the Campaign Manager 360 API +# Simple REST client for version V3_3 of the Campaign Manager 360 API This is a simple client library for version V3_3 of the Campaign Manager 360 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3_3 of the Campaign Manager 360 API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dfareporting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dfareporting service in particular.) For reference information on specific calls in the Campaign Manager 360 API, see the {Google::Apis::DfareportingV3_3::DfareportingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dfareporting_v3_3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dfareporting_v3_3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/doubleclick-advertisers/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dfareporting_v3_3/google-apis-dfareporting_v3_3.gemspec b/generated/google-apis-dfareporting_v3_3/google-apis-dfareporting_v3_3.gemspec index e27a709cd..a88a7fbe8 100644 --- a/generated/google-apis-dfareporting_v3_3/google-apis-dfareporting_v3_3.gemspec +++ b/generated/google-apis-dfareporting_v3_3/google-apis-dfareporting_v3_3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DfareportingV3_3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Campaign Manager 360 API V3_3" + gem.summary = "Simple REST client for Campaign Manager 360 API V3_3" gem.description = - "This is the legacy REST client for Campaign Manager 360 API V3_3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Campaign Manager 360 API V3_3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dfareporting_v3_3/lib/google/apis/dfareporting_v3_3/gem_version.rb b/generated/google-apis-dfareporting_v3_3/lib/google/apis/dfareporting_v3_3/gem_version.rb index 5bbbe2fee..c408c79e7 100644 --- a/generated/google-apis-dfareporting_v3_3/lib/google/apis/dfareporting_v3_3/gem_version.rb +++ b/generated/google-apis-dfareporting_v3_3/lib/google/apis/dfareporting_v3_3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201102" diff --git a/generated/google-apis-dfareporting_v3_4/CHANGELOG.md b/generated/google-apis-dfareporting_v3_4/CHANGELOG.md index 8ced266ce..307c075cc 100644 --- a/generated/google-apis-dfareporting_v3_4/CHANGELOG.md +++ b/generated/google-apis-dfareporting_v3_4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-dfareporting_v3_4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201102 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-dfareporting_v3_4/OVERVIEW.md b/generated/google-apis-dfareporting_v3_4/OVERVIEW.md index 3b5c5ea9e..e448aed08 100644 --- a/generated/google-apis-dfareporting_v3_4/OVERVIEW.md +++ b/generated/google-apis-dfareporting_v3_4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3_4 of the Campaign Manager 360 API +# Simple REST client for version V3_4 of the Campaign Manager 360 API This is a simple client library for version V3_4 of the Campaign Manager 360 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3_4 of the Campaign Manager 360 API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dfareporting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dfareporting service in particular.) For reference information on specific calls in the Campaign Manager 360 API, see the {Google::Apis::DfareportingV3_4::DfareportingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dfareporting_v3_4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dfareporting_v3_4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/doubleclick-advertisers/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dfareporting_v3_4/google-apis-dfareporting_v3_4.gemspec b/generated/google-apis-dfareporting_v3_4/google-apis-dfareporting_v3_4.gemspec index b00be8483..bdf9343a4 100644 --- a/generated/google-apis-dfareporting_v3_4/google-apis-dfareporting_v3_4.gemspec +++ b/generated/google-apis-dfareporting_v3_4/google-apis-dfareporting_v3_4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DfareportingV3_4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Campaign Manager 360 API V3_4" + gem.summary = "Simple REST client for Campaign Manager 360 API V3_4" gem.description = - "This is the legacy REST client for Campaign Manager 360 API V3_4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Campaign Manager 360 API V3_4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dfareporting_v3_4/lib/google/apis/dfareporting_v3_4/gem_version.rb b/generated/google-apis-dfareporting_v3_4/lib/google/apis/dfareporting_v3_4/gem_version.rb index 125875905..12b804a90 100644 --- a/generated/google-apis-dfareporting_v3_4/lib/google/apis/dfareporting_v3_4/gem_version.rb +++ b/generated/google-apis-dfareporting_v3_4/lib/google/apis/dfareporting_v3_4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201102" diff --git a/generated/google-apis-dialogflow_v2/OVERVIEW.md b/generated/google-apis-dialogflow_v2/OVERVIEW.md index b8403f317..a451fe206 100644 --- a/generated/google-apis-dialogflow_v2/OVERVIEW.md +++ b/generated/google-apis-dialogflow_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Dialogflow API +# Simple REST client for version V2 of the Dialogflow API This is a simple client library for version V2 of the Dialogflow API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Dialogflow API. It provide * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dialogflow service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dialogflow service in particular.) For reference information on specific calls in the Dialogflow API, see the {Google::Apis::DialogflowV2::DialogflowService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dialogflow_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dialogflow_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dialogflow/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dialogflow_v2/google-apis-dialogflow_v2.gemspec b/generated/google-apis-dialogflow_v2/google-apis-dialogflow_v2.gemspec index ae1ee2457..9e72caa5a 100644 --- a/generated/google-apis-dialogflow_v2/google-apis-dialogflow_v2.gemspec +++ b/generated/google-apis-dialogflow_v2/google-apis-dialogflow_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DialogflowV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dialogflow API V2" + gem.summary = "Simple REST client for Dialogflow API V2" gem.description = - "This is the legacy REST client for Dialogflow API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dialogflow API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dialogflow_v2beta1/OVERVIEW.md b/generated/google-apis-dialogflow_v2beta1/OVERVIEW.md index 10fc9504b..404a94292 100644 --- a/generated/google-apis-dialogflow_v2beta1/OVERVIEW.md +++ b/generated/google-apis-dialogflow_v2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta1 of the Dialogflow API +# Simple REST client for version V2beta1 of the Dialogflow API This is a simple client library for version V2beta1 of the Dialogflow API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta1 of the Dialogflow API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dialogflow service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dialogflow service in particular.) For reference information on specific calls in the Dialogflow API, see the {Google::Apis::DialogflowV2beta1::DialogflowService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dialogflow_v2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dialogflow_v2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dialogflow/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dialogflow_v2beta1/google-apis-dialogflow_v2beta1.gemspec b/generated/google-apis-dialogflow_v2beta1/google-apis-dialogflow_v2beta1.gemspec index aa1fa0363..d6399ac67 100644 --- a/generated/google-apis-dialogflow_v2beta1/google-apis-dialogflow_v2beta1.gemspec +++ b/generated/google-apis-dialogflow_v2beta1/google-apis-dialogflow_v2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DialogflowV2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dialogflow API V2beta1" + gem.summary = "Simple REST client for Dialogflow API V2beta1" gem.description = - "This is the legacy REST client for Dialogflow API V2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dialogflow API V2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dialogflow_v3/OVERVIEW.md b/generated/google-apis-dialogflow_v3/OVERVIEW.md index 2f09a9bc2..bc08ac64e 100644 --- a/generated/google-apis-dialogflow_v3/OVERVIEW.md +++ b/generated/google-apis-dialogflow_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Dialogflow API +# Simple REST client for version V3 of the Dialogflow API This is a simple client library for version V3 of the Dialogflow API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Dialogflow API. It provide * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dialogflow service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dialogflow service in particular.) For reference information on specific calls in the Dialogflow API, see the {Google::Apis::DialogflowV3::DialogflowService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dialogflow_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dialogflow_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dialogflow/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dialogflow_v3/google-apis-dialogflow_v3.gemspec b/generated/google-apis-dialogflow_v3/google-apis-dialogflow_v3.gemspec index 5b019ba34..cc726dc1f 100644 --- a/generated/google-apis-dialogflow_v3/google-apis-dialogflow_v3.gemspec +++ b/generated/google-apis-dialogflow_v3/google-apis-dialogflow_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DialogflowV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dialogflow API V3" + gem.summary = "Simple REST client for Dialogflow API V3" gem.description = - "This is the legacy REST client for Dialogflow API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dialogflow API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dialogflow_v3beta1/OVERVIEW.md b/generated/google-apis-dialogflow_v3beta1/OVERVIEW.md index 0410ef991..b0eb0023b 100644 --- a/generated/google-apis-dialogflow_v3beta1/OVERVIEW.md +++ b/generated/google-apis-dialogflow_v3beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3beta1 of the Dialogflow API +# Simple REST client for version V3beta1 of the Dialogflow API This is a simple client library for version V3beta1 of the Dialogflow API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3beta1 of the Dialogflow API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dialogflow service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dialogflow service in particular.) For reference information on specific calls in the Dialogflow API, see the {Google::Apis::DialogflowV3beta1::DialogflowService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dialogflow_v3beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dialogflow_v3beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dialogflow/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dialogflow_v3beta1/google-apis-dialogflow_v3beta1.gemspec b/generated/google-apis-dialogflow_v3beta1/google-apis-dialogflow_v3beta1.gemspec index 36d2cfa0e..7a9266db2 100644 --- a/generated/google-apis-dialogflow_v3beta1/google-apis-dialogflow_v3beta1.gemspec +++ b/generated/google-apis-dialogflow_v3beta1/google-apis-dialogflow_v3beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DialogflowV3beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dialogflow API V3beta1" + gem.summary = "Simple REST client for Dialogflow API V3beta1" gem.description = - "This is the legacy REST client for Dialogflow API V3beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dialogflow API V3beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-digitalassetlinks_v1/CHANGELOG.md b/generated/google-apis-digitalassetlinks_v1/CHANGELOG.md index 00db707c9..85db53504 100644 --- a/generated/google-apis-digitalassetlinks_v1/CHANGELOG.md +++ b/generated/google-apis-digitalassetlinks_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-digitalassetlinks_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200829 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-digitalassetlinks_v1/OVERVIEW.md b/generated/google-apis-digitalassetlinks_v1/OVERVIEW.md index ed577f0c6..f25cb9423 100644 --- a/generated/google-apis-digitalassetlinks_v1/OVERVIEW.md +++ b/generated/google-apis-digitalassetlinks_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Digital Asset Links API +# Simple REST client for version V1 of the Digital Asset Links API This is a simple client library for version V1 of the Digital Asset Links API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Digital Asset Links API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Digitalassetlinks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Digitalassetlinks service in particular.) For reference information on specific calls in the Digital Asset Links API, see the {Google::Apis::DigitalassetlinksV1::DigitalassetlinksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-digitalassetlinks_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-digitalassetlinks_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/digital-asset-links/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-digitalassetlinks_v1/google-apis-digitalassetlinks_v1.gemspec b/generated/google-apis-digitalassetlinks_v1/google-apis-digitalassetlinks_v1.gemspec index 3f4dd1918..bc88b87e0 100644 --- a/generated/google-apis-digitalassetlinks_v1/google-apis-digitalassetlinks_v1.gemspec +++ b/generated/google-apis-digitalassetlinks_v1/google-apis-digitalassetlinks_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DigitalassetlinksV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Digital Asset Links API V1" + gem.summary = "Simple REST client for Digital Asset Links API V1" gem.description = - "This is the legacy REST client for Digital Asset Links API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Digital Asset Links API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-digitalassetlinks_v1/lib/google/apis/digitalassetlinks_v1/gem_version.rb b/generated/google-apis-digitalassetlinks_v1/lib/google/apis/digitalassetlinks_v1/gem_version.rb index f0bbad360..4cdf99f6e 100644 --- a/generated/google-apis-digitalassetlinks_v1/lib/google/apis/digitalassetlinks_v1/gem_version.rb +++ b/generated/google-apis-digitalassetlinks_v1/lib/google/apis/digitalassetlinks_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200829" diff --git a/generated/google-apis-discovery_v1/CHANGELOG.md b/generated/google-apis-discovery_v1/CHANGELOG.md index 2a1c2ed3d..f0fca94e6 100644 --- a/generated/google-apis-discovery_v1/CHANGELOG.md +++ b/generated/google-apis-discovery_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-discovery_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20190129 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-discovery_v1/OVERVIEW.md b/generated/google-apis-discovery_v1/OVERVIEW.md index 13228c9fb..448684580 100644 --- a/generated/google-apis-discovery_v1/OVERVIEW.md +++ b/generated/google-apis-discovery_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the API Discovery Service +# Simple REST client for version V1 of the API Discovery Service This is a simple client library for version V1 of the API Discovery Service. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the API Discovery Service. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Discovery service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Discovery service in particular.) For reference information on specific calls in the API Discovery Service, see the {Google::Apis::DiscoveryV1::DiscoveryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-discovery_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-discovery_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/discovery/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-discovery_v1/google-apis-discovery_v1.gemspec b/generated/google-apis-discovery_v1/google-apis-discovery_v1.gemspec index 2702fea34..0b799fd0b 100644 --- a/generated/google-apis-discovery_v1/google-apis-discovery_v1.gemspec +++ b/generated/google-apis-discovery_v1/google-apis-discovery_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DiscoveryV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for API Discovery Service V1" + gem.summary = "Simple REST client for API Discovery Service V1" gem.description = - "This is the legacy REST client for API Discovery Service V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for API Discovery Service V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-discovery_v1/lib/google/apis/discovery_v1/gem_version.rb b/generated/google-apis-discovery_v1/lib/google/apis/discovery_v1/gem_version.rb index c4bbbd8c3..045e635c8 100644 --- a/generated/google-apis-discovery_v1/lib/google/apis/discovery_v1/gem_version.rb +++ b/generated/google-apis-discovery_v1/lib/google/apis/discovery_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20190129" diff --git a/generated/google-apis-displayvideo_v1/CHANGELOG.md b/generated/google-apis-displayvideo_v1/CHANGELOG.md index 73e793be6..06603414f 100644 --- a/generated/google-apis-displayvideo_v1/CHANGELOG.md +++ b/generated/google-apis-displayvideo_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-displayvideo_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-displayvideo_v1/OVERVIEW.md b/generated/google-apis-displayvideo_v1/OVERVIEW.md index 1246468cd..a8b2eca26 100644 --- a/generated/google-apis-displayvideo_v1/OVERVIEW.md +++ b/generated/google-apis-displayvideo_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Display & Video 360 API +# Simple REST client for version V1 of the Display & Video 360 API This is a simple client library for version V1 of the Display & Video 360 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Display & Video 360 API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Displayvideo service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Displayvideo service in particular.) For reference information on specific calls in the Display & Video 360 API, see the {Google::Apis::DisplayvideoV1::DisplayVideoService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-displayvideo_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-displayvideo_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/display-video/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-displayvideo_v1/google-apis-displayvideo_v1.gemspec b/generated/google-apis-displayvideo_v1/google-apis-displayvideo_v1.gemspec index 3daf43721..7c303ffbd 100644 --- a/generated/google-apis-displayvideo_v1/google-apis-displayvideo_v1.gemspec +++ b/generated/google-apis-displayvideo_v1/google-apis-displayvideo_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DisplayvideoV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Display & Video 360 API V1" + gem.summary = "Simple REST client for Display & Video 360 API V1" gem.description = - "This is the legacy REST client for Display & Video 360 API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Display & Video 360 API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-displayvideo_v1/lib/google/apis/displayvideo_v1/gem_version.rb b/generated/google-apis-displayvideo_v1/lib/google/apis/displayvideo_v1/gem_version.rb index 410c4af03..c86202728 100644 --- a/generated/google-apis-displayvideo_v1/lib/google/apis/displayvideo_v1/gem_version.rb +++ b/generated/google-apis-displayvideo_v1/lib/google/apis/displayvideo_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-dlp_v2/OVERVIEW.md b/generated/google-apis-dlp_v2/OVERVIEW.md index b4a8f18ea..70865ca46 100644 --- a/generated/google-apis-dlp_v2/OVERVIEW.md +++ b/generated/google-apis-dlp_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Data Loss Prevention (DLP) API +# Simple REST client for version V2 of the Cloud Data Loss Prevention (DLP) API This is a simple client library for version V2 of the Cloud Data Loss Prevention (DLP) API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Data Loss Prevention * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dlp service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dlp service in particular.) For reference information on specific calls in the Cloud Data Loss Prevention (DLP) API, see the {Google::Apis::DlpV2::DLPService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dlp_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dlp_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dlp/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dlp_v2/google-apis-dlp_v2.gemspec b/generated/google-apis-dlp_v2/google-apis-dlp_v2.gemspec index 04019666e..2144946cb 100644 --- a/generated/google-apis-dlp_v2/google-apis-dlp_v2.gemspec +++ b/generated/google-apis-dlp_v2/google-apis-dlp_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DlpV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Data Loss Prevention (DLP) API V2" + gem.summary = "Simple REST client for Cloud Data Loss Prevention (DLP) API V2" gem.description = - "This is the legacy REST client for Cloud Data Loss Prevention (DLP) API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Data Loss Prevention (DLP) API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dns_v1/CHANGELOG.md b/generated/google-apis-dns_v1/CHANGELOG.md index 527cd4d90..610adea63 100644 --- a/generated/google-apis-dns_v1/CHANGELOG.md +++ b/generated/google-apis-dns_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-dns_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201127 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-dns_v1/OVERVIEW.md b/generated/google-apis-dns_v1/OVERVIEW.md index d9c6bae61..2c17068aa 100644 --- a/generated/google-apis-dns_v1/OVERVIEW.md +++ b/generated/google-apis-dns_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud DNS API +# Simple REST client for version V1 of the Cloud DNS API This is a simple client library for version V1 of the Cloud DNS API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud DNS API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dns service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dns service in particular.) For reference information on specific calls in the Cloud DNS API, see the {Google::Apis::DnsV1::DnsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dns_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dns_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dns/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dns_v1/google-apis-dns_v1.gemspec b/generated/google-apis-dns_v1/google-apis-dns_v1.gemspec index 009b078ca..08d49f058 100644 --- a/generated/google-apis-dns_v1/google-apis-dns_v1.gemspec +++ b/generated/google-apis-dns_v1/google-apis-dns_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DnsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud DNS API V1" + gem.summary = "Simple REST client for Cloud DNS API V1" gem.description = - "This is the legacy REST client for Cloud DNS API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud DNS API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dns_v1/lib/google/apis/dns_v1/gem_version.rb b/generated/google-apis-dns_v1/lib/google/apis/dns_v1/gem_version.rb index deeb368da..0d81dc274 100644 --- a/generated/google-apis-dns_v1/lib/google/apis/dns_v1/gem_version.rb +++ b/generated/google-apis-dns_v1/lib/google/apis/dns_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201127" diff --git a/generated/google-apis-dns_v1beta2/CHANGELOG.md b/generated/google-apis-dns_v1beta2/CHANGELOG.md index 17a8c1d64..8ff770419 100644 --- a/generated/google-apis-dns_v1beta2/CHANGELOG.md +++ b/generated/google-apis-dns_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-dns_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201116 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-dns_v1beta2/OVERVIEW.md b/generated/google-apis-dns_v1beta2/OVERVIEW.md index 01781ce12..da001d1ea 100644 --- a/generated/google-apis-dns_v1beta2/OVERVIEW.md +++ b/generated/google-apis-dns_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud DNS API +# Simple REST client for version V1beta2 of the Cloud DNS API This is a simple client library for version V1beta2 of the Cloud DNS API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud DNS API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Dns service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Dns service in particular.) For reference information on specific calls in the Cloud DNS API, see the {Google::Apis::DnsV1beta2::DnsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-dns_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-dns_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dns/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-dns_v1beta2/google-apis-dns_v1beta2.gemspec b/generated/google-apis-dns_v1beta2/google-apis-dns_v1beta2.gemspec index a2b3c44dd..6a243d725 100644 --- a/generated/google-apis-dns_v1beta2/google-apis-dns_v1beta2.gemspec +++ b/generated/google-apis-dns_v1beta2/google-apis-dns_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DnsV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud DNS API V1beta2" + gem.summary = "Simple REST client for Cloud DNS API V1beta2" gem.description = - "This is the legacy REST client for Cloud DNS API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud DNS API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-dns_v1beta2/lib/google/apis/dns_v1beta2/gem_version.rb b/generated/google-apis-dns_v1beta2/lib/google/apis/dns_v1beta2/gem_version.rb index b5bc3611b..388579899 100644 --- a/generated/google-apis-dns_v1beta2/lib/google/apis/dns_v1beta2/gem_version.rb +++ b/generated/google-apis-dns_v1beta2/lib/google/apis/dns_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201116" diff --git a/generated/google-apis-docs_v1/CHANGELOG.md b/generated/google-apis-docs_v1/CHANGELOG.md index c93093d14..b38f09f44 100644 --- a/generated/google-apis-docs_v1/CHANGELOG.md +++ b/generated/google-apis-docs_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-docs_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-docs_v1/OVERVIEW.md b/generated/google-apis-docs_v1/OVERVIEW.md index 848d3a073..ee7da3969 100644 --- a/generated/google-apis-docs_v1/OVERVIEW.md +++ b/generated/google-apis-docs_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Docs API +# Simple REST client for version V1 of the Google Docs API This is a simple client library for version V1 of the Google Docs API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Docs API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Docs service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Docs service in particular.) For reference information on specific calls in the Google Docs API, see the {Google::Apis::DocsV1::DocsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-docs_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-docs_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-docs_v1/google-apis-docs_v1.gemspec b/generated/google-apis-docs_v1/google-apis-docs_v1.gemspec index a0e89a7ec..7bb433bbb 100644 --- a/generated/google-apis-docs_v1/google-apis-docs_v1.gemspec +++ b/generated/google-apis-docs_v1/google-apis-docs_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DocsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Docs API V1" + gem.summary = "Simple REST client for Google Docs API V1" gem.description = - "This is the legacy REST client for Google Docs API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Docs API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-docs_v1/lib/google/apis/docs_v1/gem_version.rb b/generated/google-apis-docs_v1/lib/google/apis/docs_v1/gem_version.rb index 607b15ba1..aa7ed0086 100644 --- a/generated/google-apis-docs_v1/lib/google/apis/docs_v1/gem_version.rb +++ b/generated/google-apis-docs_v1/lib/google/apis/docs_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-documentai_v1beta2/OVERVIEW.md b/generated/google-apis-documentai_v1beta2/OVERVIEW.md index 50ea01699..5cd51ebcb 100644 --- a/generated/google-apis-documentai_v1beta2/OVERVIEW.md +++ b/generated/google-apis-documentai_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Document AI API +# Simple REST client for version V1beta2 of the Cloud Document AI API This is a simple client library for version V1beta2 of the Cloud Document AI API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Document AI API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Documentai service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Documentai service in particular.) For reference information on specific calls in the Cloud Document AI API, see the {Google::Apis::DocumentaiV1beta2::DocumentService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-documentai_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-documentai_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/document-ai/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-documentai_v1beta2/google-apis-documentai_v1beta2.gemspec b/generated/google-apis-documentai_v1beta2/google-apis-documentai_v1beta2.gemspec index fb3304189..e82e10b63 100644 --- a/generated/google-apis-documentai_v1beta2/google-apis-documentai_v1beta2.gemspec +++ b/generated/google-apis-documentai_v1beta2/google-apis-documentai_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DocumentaiV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Document AI API V1beta2" + gem.summary = "Simple REST client for Cloud Document AI API V1beta2" gem.description = - "This is the legacy REST client for Cloud Document AI API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Document AI API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-documentai_v1beta3/OVERVIEW.md b/generated/google-apis-documentai_v1beta3/OVERVIEW.md index 76fc93de8..86ac1807b 100644 --- a/generated/google-apis-documentai_v1beta3/OVERVIEW.md +++ b/generated/google-apis-documentai_v1beta3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta3 of the Cloud Document AI API +# Simple REST client for version V1beta3 of the Cloud Document AI API This is a simple client library for version V1beta3 of the Cloud Document AI API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta3 of the Cloud Document AI API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Documentai service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Documentai service in particular.) For reference information on specific calls in the Cloud Document AI API, see the {Google::Apis::DocumentaiV1beta3::DocumentService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-documentai_v1beta3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-documentai_v1beta3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/document-ai/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-documentai_v1beta3/google-apis-documentai_v1beta3.gemspec b/generated/google-apis-documentai_v1beta3/google-apis-documentai_v1beta3.gemspec index 411577bdc..3b633886c 100644 --- a/generated/google-apis-documentai_v1beta3/google-apis-documentai_v1beta3.gemspec +++ b/generated/google-apis-documentai_v1beta3/google-apis-documentai_v1beta3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DocumentaiV1beta3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Document AI API V1beta3" + gem.summary = "Simple REST client for Cloud Document AI API V1beta3" gem.description = - "This is the legacy REST client for Cloud Document AI API V1beta3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Document AI API V1beta3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-domains_v1alpha2/CHANGELOG.md b/generated/google-apis-domains_v1alpha2/CHANGELOG.md index c9474ef56..8852dfda0 100644 --- a/generated/google-apis-domains_v1alpha2/CHANGELOG.md +++ b/generated/google-apis-domains_v1alpha2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-domains_v1alpha2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201110 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-domains_v1alpha2/OVERVIEW.md b/generated/google-apis-domains_v1alpha2/OVERVIEW.md index f4a755965..65127d38a 100644 --- a/generated/google-apis-domains_v1alpha2/OVERVIEW.md +++ b/generated/google-apis-domains_v1alpha2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha2 of the Cloud Domains API +# Simple REST client for version V1alpha2 of the Cloud Domains API This is a simple client library for version V1alpha2 of the Cloud Domains API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha2 of the Cloud Domains API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Domains service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Domains service in particular.) For reference information on specific calls in the Cloud Domains API, see the {Google::Apis::DomainsV1alpha2::CloudDomainsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-domains_v1alpha2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-domains_v1alpha2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/domains/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-domains_v1alpha2/google-apis-domains_v1alpha2.gemspec b/generated/google-apis-domains_v1alpha2/google-apis-domains_v1alpha2.gemspec index 6266ad3f9..f88ab11fb 100644 --- a/generated/google-apis-domains_v1alpha2/google-apis-domains_v1alpha2.gemspec +++ b/generated/google-apis-domains_v1alpha2/google-apis-domains_v1alpha2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DomainsV1alpha2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Domains API V1alpha2" + gem.summary = "Simple REST client for Cloud Domains API V1alpha2" gem.description = - "This is the legacy REST client for Cloud Domains API V1alpha2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Domains API V1alpha2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-domains_v1alpha2/lib/google/apis/domains_v1alpha2/gem_version.rb b/generated/google-apis-domains_v1alpha2/lib/google/apis/domains_v1alpha2/gem_version.rb index 8bdd81a08..42ebe9bd4 100644 --- a/generated/google-apis-domains_v1alpha2/lib/google/apis/domains_v1alpha2/gem_version.rb +++ b/generated/google-apis-domains_v1alpha2/lib/google/apis/domains_v1alpha2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201110" diff --git a/generated/google-apis-domains_v1beta1/CHANGELOG.md b/generated/google-apis-domains_v1beta1/CHANGELOG.md index 8518ae1e0..9c111053f 100644 --- a/generated/google-apis-domains_v1beta1/CHANGELOG.md +++ b/generated/google-apis-domains_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-domains_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201110 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-domains_v1beta1/OVERVIEW.md b/generated/google-apis-domains_v1beta1/OVERVIEW.md index 8ad1c37c3..7460652cb 100644 --- a/generated/google-apis-domains_v1beta1/OVERVIEW.md +++ b/generated/google-apis-domains_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Domains API +# Simple REST client for version V1beta1 of the Cloud Domains API This is a simple client library for version V1beta1 of the Cloud Domains API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Domains API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Domains service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Domains service in particular.) For reference information on specific calls in the Cloud Domains API, see the {Google::Apis::DomainsV1beta1::CloudDomainsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-domains_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-domains_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/domains/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-domains_v1beta1/google-apis-domains_v1beta1.gemspec b/generated/google-apis-domains_v1beta1/google-apis-domains_v1beta1.gemspec index 3246bf8ea..9264f84a8 100644 --- a/generated/google-apis-domains_v1beta1/google-apis-domains_v1beta1.gemspec +++ b/generated/google-apis-domains_v1beta1/google-apis-domains_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DomainsV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Domains API V1beta1" + gem.summary = "Simple REST client for Cloud Domains API V1beta1" gem.description = - "This is the legacy REST client for Cloud Domains API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Domains API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-domains_v1beta1/lib/google/apis/domains_v1beta1/gem_version.rb b/generated/google-apis-domains_v1beta1/lib/google/apis/domains_v1beta1/gem_version.rb index 3f359aee5..f3c88cb8d 100644 --- a/generated/google-apis-domains_v1beta1/lib/google/apis/domains_v1beta1/gem_version.rb +++ b/generated/google-apis-domains_v1beta1/lib/google/apis/domains_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201110" diff --git a/generated/google-apis-domainsrdap_v1/CHANGELOG.md b/generated/google-apis-domainsrdap_v1/CHANGELOG.md index e70183f15..7034168ef 100644 --- a/generated/google-apis-domainsrdap_v1/CHANGELOG.md +++ b/generated/google-apis-domainsrdap_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-domainsrdap_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-domainsrdap_v1/OVERVIEW.md b/generated/google-apis-domainsrdap_v1/OVERVIEW.md index 96c5e71c1..fbb551321 100644 --- a/generated/google-apis-domainsrdap_v1/OVERVIEW.md +++ b/generated/google-apis-domainsrdap_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Domains RDAP API +# Simple REST client for version V1 of the Domains RDAP API This is a simple client library for version V1 of the Domains RDAP API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Domains RDAP API. It provi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Domainsrdap service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Domainsrdap service in particular.) For reference information on specific calls in the Domains RDAP API, see the {Google::Apis::DomainsrdapV1::DomainsRDAPService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-domainsrdap_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-domainsrdap_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/domains/rdap/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-domainsrdap_v1/google-apis-domainsrdap_v1.gemspec b/generated/google-apis-domainsrdap_v1/google-apis-domainsrdap_v1.gemspec index a608cb1ba..a18eaf0d3 100644 --- a/generated/google-apis-domainsrdap_v1/google-apis-domainsrdap_v1.gemspec +++ b/generated/google-apis-domainsrdap_v1/google-apis-domainsrdap_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DomainsrdapV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Domains RDAP API V1" + gem.summary = "Simple REST client for Domains RDAP API V1" gem.description = - "This is the legacy REST client for Domains RDAP API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Domains RDAP API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-domainsrdap_v1/lib/google/apis/domainsrdap_v1/gem_version.rb b/generated/google-apis-domainsrdap_v1/lib/google/apis/domainsrdap_v1/gem_version.rb index 677c93187..0cd39b760 100644 --- a/generated/google-apis-domainsrdap_v1/lib/google/apis/domainsrdap_v1/gem_version.rb +++ b/generated/google-apis-domainsrdap_v1/lib/google/apis/domainsrdap_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-doubleclickbidmanager_v1/CHANGELOG.md b/generated/google-apis-doubleclickbidmanager_v1/CHANGELOG.md index 1504bf475..8041760fc 100644 --- a/generated/google-apis-doubleclickbidmanager_v1/CHANGELOG.md +++ b/generated/google-apis-doubleclickbidmanager_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-doubleclickbidmanager_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201016 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-doubleclickbidmanager_v1/OVERVIEW.md b/generated/google-apis-doubleclickbidmanager_v1/OVERVIEW.md index afc97f7f7..9a559f097 100644 --- a/generated/google-apis-doubleclickbidmanager_v1/OVERVIEW.md +++ b/generated/google-apis-doubleclickbidmanager_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the DoubleClick Bid Manager API +# Simple REST client for version V1 of the DoubleClick Bid Manager API This is a simple client library for version V1 of the DoubleClick Bid Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the DoubleClick Bid Manager AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Doubleclickbidmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Doubleclickbidmanager service in particular.) For reference information on specific calls in the DoubleClick Bid Manager API, see the {Google::Apis::DoubleclickbidmanagerV1::DoubleClickBidManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-doubleclickbidmanager_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-doubleclickbidmanager_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/bid-manager/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-doubleclickbidmanager_v1/google-apis-doubleclickbidmanager_v1.gemspec b/generated/google-apis-doubleclickbidmanager_v1/google-apis-doubleclickbidmanager_v1.gemspec index 9996c7b8f..772047e4a 100644 --- a/generated/google-apis-doubleclickbidmanager_v1/google-apis-doubleclickbidmanager_v1.gemspec +++ b/generated/google-apis-doubleclickbidmanager_v1/google-apis-doubleclickbidmanager_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DoubleclickbidmanagerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for DoubleClick Bid Manager API V1" + gem.summary = "Simple REST client for DoubleClick Bid Manager API V1" gem.description = - "This is the legacy REST client for DoubleClick Bid Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for DoubleClick Bid Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-doubleclickbidmanager_v1/lib/google/apis/doubleclickbidmanager_v1/gem_version.rb b/generated/google-apis-doubleclickbidmanager_v1/lib/google/apis/doubleclickbidmanager_v1/gem_version.rb index b03ced7f8..fdef68439 100644 --- a/generated/google-apis-doubleclickbidmanager_v1/lib/google/apis/doubleclickbidmanager_v1/gem_version.rb +++ b/generated/google-apis-doubleclickbidmanager_v1/lib/google/apis/doubleclickbidmanager_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201016" diff --git a/generated/google-apis-doubleclickbidmanager_v1_1/CHANGELOG.md b/generated/google-apis-doubleclickbidmanager_v1_1/CHANGELOG.md index 236b7d296..697a5bcc9 100644 --- a/generated/google-apis-doubleclickbidmanager_v1_1/CHANGELOG.md +++ b/generated/google-apis-doubleclickbidmanager_v1_1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-doubleclickbidmanager_v1_1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-doubleclickbidmanager_v1_1/OVERVIEW.md b/generated/google-apis-doubleclickbidmanager_v1_1/OVERVIEW.md index 100842bee..4c6d315ec 100644 --- a/generated/google-apis-doubleclickbidmanager_v1_1/OVERVIEW.md +++ b/generated/google-apis-doubleclickbidmanager_v1_1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1_1 of the DoubleClick Bid Manager API +# Simple REST client for version V1_1 of the DoubleClick Bid Manager API This is a simple client library for version V1_1 of the DoubleClick Bid Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1_1 of the DoubleClick Bid Manager * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Doubleclickbidmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Doubleclickbidmanager service in particular.) For reference information on specific calls in the DoubleClick Bid Manager API, see the {Google::Apis::DoubleclickbidmanagerV1_1::DoubleClickBidManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-doubleclickbidmanager_v1_1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-doubleclickbidmanager_v1_1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/bid-manager/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-doubleclickbidmanager_v1_1/google-apis-doubleclickbidmanager_v1_1.gemspec b/generated/google-apis-doubleclickbidmanager_v1_1/google-apis-doubleclickbidmanager_v1_1.gemspec index 2fa2ec61d..be54bac32 100644 --- a/generated/google-apis-doubleclickbidmanager_v1_1/google-apis-doubleclickbidmanager_v1_1.gemspec +++ b/generated/google-apis-doubleclickbidmanager_v1_1/google-apis-doubleclickbidmanager_v1_1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DoubleclickbidmanagerV1_1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for DoubleClick Bid Manager API V1_1" + gem.summary = "Simple REST client for DoubleClick Bid Manager API V1_1" gem.description = - "This is the legacy REST client for DoubleClick Bid Manager API V1_1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for DoubleClick Bid Manager API V1_1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-doubleclickbidmanager_v1_1/lib/google/apis/doubleclickbidmanager_v1_1/gem_version.rb b/generated/google-apis-doubleclickbidmanager_v1_1/lib/google/apis/doubleclickbidmanager_v1_1/gem_version.rb index 61c6a87e4..84f9d1970 100644 --- a/generated/google-apis-doubleclickbidmanager_v1_1/lib/google/apis/doubleclickbidmanager_v1_1/gem_version.rb +++ b/generated/google-apis-doubleclickbidmanager_v1_1/lib/google/apis/doubleclickbidmanager_v1_1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-doubleclicksearch_v2/CHANGELOG.md b/generated/google-apis-doubleclicksearch_v2/CHANGELOG.md index 0de0e458f..2024bf7b6 100644 --- a/generated/google-apis-doubleclicksearch_v2/CHANGELOG.md +++ b/generated/google-apis-doubleclicksearch_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-doubleclicksearch_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200825 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-doubleclicksearch_v2/OVERVIEW.md b/generated/google-apis-doubleclicksearch_v2/OVERVIEW.md index ba15dba6c..7cb1b2fc5 100644 --- a/generated/google-apis-doubleclicksearch_v2/OVERVIEW.md +++ b/generated/google-apis-doubleclicksearch_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Search Ads 360 API +# Simple REST client for version V2 of the Search Ads 360 API This is a simple client library for version V2 of the Search Ads 360 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Search Ads 360 API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Doubleclicksearch service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Doubleclicksearch service in particular.) For reference information on specific calls in the Search Ads 360 API, see the {Google::Apis::DoubleclicksearchV2::DoubleclicksearchService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-doubleclicksearch_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-doubleclicksearch_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/search-ads) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-doubleclicksearch_v2/google-apis-doubleclicksearch_v2.gemspec b/generated/google-apis-doubleclicksearch_v2/google-apis-doubleclicksearch_v2.gemspec index 9922ea069..56759d005 100644 --- a/generated/google-apis-doubleclicksearch_v2/google-apis-doubleclicksearch_v2.gemspec +++ b/generated/google-apis-doubleclicksearch_v2/google-apis-doubleclicksearch_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DoubleclicksearchV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Search Ads 360 API V2" + gem.summary = "Simple REST client for Search Ads 360 API V2" gem.description = - "This is the legacy REST client for Search Ads 360 API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Search Ads 360 API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-doubleclicksearch_v2/lib/google/apis/doubleclicksearch_v2/gem_version.rb b/generated/google-apis-doubleclicksearch_v2/lib/google/apis/doubleclicksearch_v2/gem_version.rb index 48bafe692..73648bd4f 100644 --- a/generated/google-apis-doubleclicksearch_v2/lib/google/apis/doubleclicksearch_v2/gem_version.rb +++ b/generated/google-apis-doubleclicksearch_v2/lib/google/apis/doubleclicksearch_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200825" diff --git a/generated/google-apis-drive_v2/CHANGELOG.md b/generated/google-apis-drive_v2/CHANGELOG.md index f2be3c88e..30ebf11a0 100644 --- a/generated/google-apis-drive_v2/CHANGELOG.md +++ b/generated/google-apis-drive_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-drive_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201130 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-drive_v2/OVERVIEW.md b/generated/google-apis-drive_v2/OVERVIEW.md index b2e1fb925..013198017 100644 --- a/generated/google-apis-drive_v2/OVERVIEW.md +++ b/generated/google-apis-drive_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Drive API +# Simple REST client for version V2 of the Drive API This is a simple client library for version V2 of the Drive API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Drive API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Drive service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Drive service in particular.) For reference information on specific calls in the Drive API, see the {Google::Apis::DriveV2::DriveService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-drive_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-drive_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/drive/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-drive_v2/google-apis-drive_v2.gemspec b/generated/google-apis-drive_v2/google-apis-drive_v2.gemspec index 42e1ea13d..13a768a6f 100644 --- a/generated/google-apis-drive_v2/google-apis-drive_v2.gemspec +++ b/generated/google-apis-drive_v2/google-apis-drive_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DriveV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Drive API V2" + gem.summary = "Simple REST client for Drive API V2" gem.description = - "This is the legacy REST client for Drive API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Drive API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-drive_v2/lib/google/apis/drive_v2/gem_version.rb b/generated/google-apis-drive_v2/lib/google/apis/drive_v2/gem_version.rb index b05d6f8d0..aed62be6c 100644 --- a/generated/google-apis-drive_v2/lib/google/apis/drive_v2/gem_version.rb +++ b/generated/google-apis-drive_v2/lib/google/apis/drive_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201130" diff --git a/generated/google-apis-drive_v3/CHANGELOG.md b/generated/google-apis-drive_v3/CHANGELOG.md index ed0154454..619e02021 100644 --- a/generated/google-apis-drive_v3/CHANGELOG.md +++ b/generated/google-apis-drive_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-drive_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201130 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-drive_v3/OVERVIEW.md b/generated/google-apis-drive_v3/OVERVIEW.md index eb293973e..390e81753 100644 --- a/generated/google-apis-drive_v3/OVERVIEW.md +++ b/generated/google-apis-drive_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Drive API +# Simple REST client for version V3 of the Drive API This is a simple client library for version V3 of the Drive API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Drive API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Drive service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Drive service in particular.) For reference information on specific calls in the Drive API, see the {Google::Apis::DriveV3::DriveService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-drive_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-drive_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/drive/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-drive_v3/google-apis-drive_v3.gemspec b/generated/google-apis-drive_v3/google-apis-drive_v3.gemspec index 43fe7c7b5..c7f41d4b1 100644 --- a/generated/google-apis-drive_v3/google-apis-drive_v3.gemspec +++ b/generated/google-apis-drive_v3/google-apis-drive_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DriveV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Drive API V3" + gem.summary = "Simple REST client for Drive API V3" gem.description = - "This is the legacy REST client for Drive API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Drive API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-drive_v3/lib/google/apis/drive_v3/gem_version.rb b/generated/google-apis-drive_v3/lib/google/apis/drive_v3/gem_version.rb index 4c610d35e..1c11069d5 100644 --- a/generated/google-apis-drive_v3/lib/google/apis/drive_v3/gem_version.rb +++ b/generated/google-apis-drive_v3/lib/google/apis/drive_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201130" diff --git a/generated/google-apis-driveactivity_v2/CHANGELOG.md b/generated/google-apis-driveactivity_v2/CHANGELOG.md index 88ca1160b..0b15f6070 100644 --- a/generated/google-apis-driveactivity_v2/CHANGELOG.md +++ b/generated/google-apis-driveactivity_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-driveactivity_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-driveactivity_v2/OVERVIEW.md b/generated/google-apis-driveactivity_v2/OVERVIEW.md index f1295aa2c..f7c2881ac 100644 --- a/generated/google-apis-driveactivity_v2/OVERVIEW.md +++ b/generated/google-apis-driveactivity_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Drive Activity API +# Simple REST client for version V2 of the Drive Activity API This is a simple client library for version V2 of the Drive Activity API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Drive Activity API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Driveactivity service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Driveactivity service in particular.) For reference information on specific calls in the Drive Activity API, see the {Google::Apis::DriveactivityV2::DriveActivityService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-driveactivity_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-driveactivity_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/drive/activity/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-driveactivity_v2/google-apis-driveactivity_v2.gemspec b/generated/google-apis-driveactivity_v2/google-apis-driveactivity_v2.gemspec index f77d27d78..fd8f55d47 100644 --- a/generated/google-apis-driveactivity_v2/google-apis-driveactivity_v2.gemspec +++ b/generated/google-apis-driveactivity_v2/google-apis-driveactivity_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::DriveactivityV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Drive Activity API V2" + gem.summary = "Simple REST client for Drive Activity API V2" gem.description = - "This is the legacy REST client for Drive Activity API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Drive Activity API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-driveactivity_v2/lib/google/apis/driveactivity_v2/gem_version.rb b/generated/google-apis-driveactivity_v2/lib/google/apis/driveactivity_v2/gem_version.rb index 53265d640..94a8e3093 100644 --- a/generated/google-apis-driveactivity_v2/lib/google/apis/driveactivity_v2/gem_version.rb +++ b/generated/google-apis-driveactivity_v2/lib/google/apis/driveactivity_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-eventarc_v1beta1/CHANGELOG.md b/generated/google-apis-eventarc_v1beta1/CHANGELOG.md index ab292ce73..300f35e20 100644 --- a/generated/google-apis-eventarc_v1beta1/CHANGELOG.md +++ b/generated/google-apis-eventarc_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-eventarc_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-eventarc_v1beta1/OVERVIEW.md b/generated/google-apis-eventarc_v1beta1/OVERVIEW.md index fe2f55a25..28bce487a 100644 --- a/generated/google-apis-eventarc_v1beta1/OVERVIEW.md +++ b/generated/google-apis-eventarc_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Eventarc API +# Simple REST client for version V1beta1 of the Eventarc API This is a simple client library for version V1beta1 of the Eventarc API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Eventarc API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Eventarc service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Eventarc service in particular.) For reference information on specific calls in the Eventarc API, see the {Google::Apis::EventarcV1beta1::EventarcService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-eventarc_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-eventarc_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/eventarc) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-eventarc_v1beta1/google-apis-eventarc_v1beta1.gemspec b/generated/google-apis-eventarc_v1beta1/google-apis-eventarc_v1beta1.gemspec index a0ee88ccc..af606a780 100644 --- a/generated/google-apis-eventarc_v1beta1/google-apis-eventarc_v1beta1.gemspec +++ b/generated/google-apis-eventarc_v1beta1/google-apis-eventarc_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::EventarcV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Eventarc API V1beta1" + gem.summary = "Simple REST client for Eventarc API V1beta1" gem.description = - "This is the legacy REST client for Eventarc API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Eventarc API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-eventarc_v1beta1/lib/google/apis/eventarc_v1beta1/gem_version.rb b/generated/google-apis-eventarc_v1beta1/lib/google/apis/eventarc_v1beta1/gem_version.rb index dd2a71e57..9c44e9021 100644 --- a/generated/google-apis-eventarc_v1beta1/lib/google/apis/eventarc_v1beta1/gem_version.rb +++ b/generated/google-apis-eventarc_v1beta1/lib/google/apis/eventarc_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-factchecktools_v1alpha1/CHANGELOG.md b/generated/google-apis-factchecktools_v1alpha1/CHANGELOG.md index 76a7e156c..52bd5514b 100644 --- a/generated/google-apis-factchecktools_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-factchecktools_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-factchecktools_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-factchecktools_v1alpha1/OVERVIEW.md b/generated/google-apis-factchecktools_v1alpha1/OVERVIEW.md index eff958781..2310c9bb7 100644 --- a/generated/google-apis-factchecktools_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-factchecktools_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Fact Check Tools API +# Simple REST client for version V1alpha1 of the Fact Check Tools API This is a simple client library for version V1alpha1 of the Fact Check Tools API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Fact Check Tools API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Factchecktools service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Factchecktools service in particular.) For reference information on specific calls in the Fact Check Tools API, see the {Google::Apis::FactchecktoolsV1alpha1::FactCheckToolsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-factchecktools_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-factchecktools_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/fact-check/tools/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-factchecktools_v1alpha1/google-apis-factchecktools_v1alpha1.gemspec b/generated/google-apis-factchecktools_v1alpha1/google-apis-factchecktools_v1alpha1.gemspec index e0814dc59..5349315bb 100644 --- a/generated/google-apis-factchecktools_v1alpha1/google-apis-factchecktools_v1alpha1.gemspec +++ b/generated/google-apis-factchecktools_v1alpha1/google-apis-factchecktools_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FactchecktoolsV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Fact Check Tools API V1alpha1" + gem.summary = "Simple REST client for Fact Check Tools API V1alpha1" gem.description = - "This is the legacy REST client for Fact Check Tools API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Fact Check Tools API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-factchecktools_v1alpha1/lib/google/apis/factchecktools_v1alpha1/gem_version.rb b/generated/google-apis-factchecktools_v1alpha1/lib/google/apis/factchecktools_v1alpha1/gem_version.rb index 7f942d35c..86e7ece0f 100644 --- a/generated/google-apis-factchecktools_v1alpha1/lib/google/apis/factchecktools_v1alpha1/gem_version.rb +++ b/generated/google-apis-factchecktools_v1alpha1/lib/google/apis/factchecktools_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-fcm_v1/CHANGELOG.md b/generated/google-apis-fcm_v1/CHANGELOG.md index cfd6ed1e4..db52dd8c6 100644 --- a/generated/google-apis-fcm_v1/CHANGELOG.md +++ b/generated/google-apis-fcm_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-fcm_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200720 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-fcm_v1/OVERVIEW.md b/generated/google-apis-fcm_v1/OVERVIEW.md index 0febdb2a8..bee7929c0 100644 --- a/generated/google-apis-fcm_v1/OVERVIEW.md +++ b/generated/google-apis-fcm_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Firebase Cloud Messaging API +# Simple REST client for version V1 of the Firebase Cloud Messaging API This is a simple client library for version V1 of the Firebase Cloud Messaging API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Firebase Cloud Messaging A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Fcm service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Fcm service in particular.) For reference information on specific calls in the Firebase Cloud Messaging API, see the {Google::Apis::FcmV1::FirebaseCloudMessagingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-fcm_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-fcm_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/cloud-messaging) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-fcm_v1/google-apis-fcm_v1.gemspec b/generated/google-apis-fcm_v1/google-apis-fcm_v1.gemspec index abf39f3e4..e501b81dc 100644 --- a/generated/google-apis-fcm_v1/google-apis-fcm_v1.gemspec +++ b/generated/google-apis-fcm_v1/google-apis-fcm_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FcmV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Cloud Messaging API V1" + gem.summary = "Simple REST client for Firebase Cloud Messaging API V1" gem.description = - "This is the legacy REST client for Firebase Cloud Messaging API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Cloud Messaging API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-fcm_v1/lib/google/apis/fcm_v1/gem_version.rb b/generated/google-apis-fcm_v1/lib/google/apis/fcm_v1/gem_version.rb index 2fe9f6727..2d74e5a72 100644 --- a/generated/google-apis-fcm_v1/lib/google/apis/fcm_v1/gem_version.rb +++ b/generated/google-apis-fcm_v1/lib/google/apis/fcm_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200720" diff --git a/generated/google-apis-file_v1/CHANGELOG.md b/generated/google-apis-file_v1/CHANGELOG.md index 12e2c72bd..1603df36d 100644 --- a/generated/google-apis-file_v1/CHANGELOG.md +++ b/generated/google-apis-file_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-file_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-file_v1/OVERVIEW.md b/generated/google-apis-file_v1/OVERVIEW.md index aaed3dbc6..ba1f1d6bd 100644 --- a/generated/google-apis-file_v1/OVERVIEW.md +++ b/generated/google-apis-file_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Filestore API +# Simple REST client for version V1 of the Cloud Filestore API This is a simple client library for version V1 of the Cloud Filestore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Filestore API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the File service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the File service in particular.) For reference information on specific calls in the Cloud Filestore API, see the {Google::Apis::FileV1::CloudFilestoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-file_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-file_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/filestore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-file_v1/google-apis-file_v1.gemspec b/generated/google-apis-file_v1/google-apis-file_v1.gemspec index 20a3199dd..78dad5e1f 100644 --- a/generated/google-apis-file_v1/google-apis-file_v1.gemspec +++ b/generated/google-apis-file_v1/google-apis-file_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FileV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Filestore API V1" + gem.summary = "Simple REST client for Cloud Filestore API V1" gem.description = - "This is the legacy REST client for Cloud Filestore API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Filestore API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-file_v1/lib/google/apis/file_v1/gem_version.rb b/generated/google-apis-file_v1/lib/google/apis/file_v1/gem_version.rb index fbed427b8..e02b6fa80 100644 --- a/generated/google-apis-file_v1/lib/google/apis/file_v1/gem_version.rb +++ b/generated/google-apis-file_v1/lib/google/apis/file_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-file_v1beta1/CHANGELOG.md b/generated/google-apis-file_v1beta1/CHANGELOG.md index af5fe5f0a..d632845f3 100644 --- a/generated/google-apis-file_v1beta1/CHANGELOG.md +++ b/generated/google-apis-file_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-file_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201029 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-file_v1beta1/OVERVIEW.md b/generated/google-apis-file_v1beta1/OVERVIEW.md index 25b86a543..8eac416de 100644 --- a/generated/google-apis-file_v1beta1/OVERVIEW.md +++ b/generated/google-apis-file_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Filestore API +# Simple REST client for version V1beta1 of the Cloud Filestore API This is a simple client library for version V1beta1 of the Cloud Filestore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Filestore API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the File service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the File service in particular.) For reference information on specific calls in the Cloud Filestore API, see the {Google::Apis::FileV1beta1::CloudFilestoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-file_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-file_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/filestore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-file_v1beta1/google-apis-file_v1beta1.gemspec b/generated/google-apis-file_v1beta1/google-apis-file_v1beta1.gemspec index 92f23522e..737c154ee 100644 --- a/generated/google-apis-file_v1beta1/google-apis-file_v1beta1.gemspec +++ b/generated/google-apis-file_v1beta1/google-apis-file_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FileV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Filestore API V1beta1" + gem.summary = "Simple REST client for Cloud Filestore API V1beta1" gem.description = - "This is the legacy REST client for Cloud Filestore API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Filestore API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-file_v1beta1/lib/google/apis/file_v1beta1/gem_version.rb b/generated/google-apis-file_v1beta1/lib/google/apis/file_v1beta1/gem_version.rb index fafc020e9..365cb7323 100644 --- a/generated/google-apis-file_v1beta1/lib/google/apis/file_v1beta1/gem_version.rb +++ b/generated/google-apis-file_v1beta1/lib/google/apis/file_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201029" diff --git a/generated/google-apis-firebase_v1beta1/CHANGELOG.md b/generated/google-apis-firebase_v1beta1/CHANGELOG.md index 2d5493bbd..f3f386e99 100644 --- a/generated/google-apis-firebase_v1beta1/CHANGELOG.md +++ b/generated/google-apis-firebase_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebase_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201027 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebase_v1beta1/OVERVIEW.md b/generated/google-apis-firebase_v1beta1/OVERVIEW.md index 15ea464d1..85825a1c8 100644 --- a/generated/google-apis-firebase_v1beta1/OVERVIEW.md +++ b/generated/google-apis-firebase_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Firebase Management API +# Simple REST client for version V1beta1 of the Firebase Management API This is a simple client library for version V1beta1 of the Firebase Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Firebase Management A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebase service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebase service in particular.) For reference information on specific calls in the Firebase Management API, see the {Google::Apis::FirebaseV1beta1::FirebaseManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebase_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebase_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebase_v1beta1/google-apis-firebase_v1beta1.gemspec b/generated/google-apis-firebase_v1beta1/google-apis-firebase_v1beta1.gemspec index 765ec76d4..9dc7f27d4 100644 --- a/generated/google-apis-firebase_v1beta1/google-apis-firebase_v1beta1.gemspec +++ b/generated/google-apis-firebase_v1beta1/google-apis-firebase_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebaseV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Management API V1beta1" + gem.summary = "Simple REST client for Firebase Management API V1beta1" gem.description = - "This is the legacy REST client for Firebase Management API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Management API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebase_v1beta1/lib/google/apis/firebase_v1beta1/gem_version.rb b/generated/google-apis-firebase_v1beta1/lib/google/apis/firebase_v1beta1/gem_version.rb index a3314de5b..0cf23e37a 100644 --- a/generated/google-apis-firebase_v1beta1/lib/google/apis/firebase_v1beta1/gem_version.rb +++ b/generated/google-apis-firebase_v1beta1/lib/google/apis/firebase_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201027" diff --git a/generated/google-apis-firebasedatabase_v1beta/CHANGELOG.md b/generated/google-apis-firebasedatabase_v1beta/CHANGELOG.md index 61ff59f4f..69611bc61 100644 --- a/generated/google-apis-firebasedatabase_v1beta/CHANGELOG.md +++ b/generated/google-apis-firebasedatabase_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebasedatabase_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebasedatabase_v1beta/OVERVIEW.md b/generated/google-apis-firebasedatabase_v1beta/OVERVIEW.md index 0a333b09c..974042fb3 100644 --- a/generated/google-apis-firebasedatabase_v1beta/OVERVIEW.md +++ b/generated/google-apis-firebasedatabase_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Firebase Realtime Database Management API +# Simple REST client for version V1beta of the Firebase Realtime Database Management API This is a simple client library for version V1beta of the Firebase Realtime Database Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Firebase Realtime Data * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebasedatabase service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebasedatabase service in particular.) For reference information on specific calls in the Firebase Realtime Database Management API, see the {Google::Apis::FirebasedatabaseV1beta::FirebaseRealtimeDatabaseService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebasedatabase_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebasedatabase_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/reference/rest/database/database-management/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebasedatabase_v1beta/google-apis-firebasedatabase_v1beta.gemspec b/generated/google-apis-firebasedatabase_v1beta/google-apis-firebasedatabase_v1beta.gemspec index 5c8e51f0d..0df265945 100644 --- a/generated/google-apis-firebasedatabase_v1beta/google-apis-firebasedatabase_v1beta.gemspec +++ b/generated/google-apis-firebasedatabase_v1beta/google-apis-firebasedatabase_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasedatabaseV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Realtime Database Management API V1beta" + gem.summary = "Simple REST client for Firebase Realtime Database Management API V1beta" gem.description = - "This is the legacy REST client for Firebase Realtime Database Management API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Realtime Database Management API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebasedatabase_v1beta/lib/google/apis/firebasedatabase_v1beta/gem_version.rb b/generated/google-apis-firebasedatabase_v1beta/lib/google/apis/firebasedatabase_v1beta/gem_version.rb index b5c6f1a75..0ac5fc9bc 100644 --- a/generated/google-apis-firebasedatabase_v1beta/lib/google/apis/firebasedatabase_v1beta/gem_version.rb +++ b/generated/google-apis-firebasedatabase_v1beta/lib/google/apis/firebasedatabase_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-firebasedynamiclinks_v1/CHANGELOG.md b/generated/google-apis-firebasedynamiclinks_v1/CHANGELOG.md index b49edcec9..9f9d09bb6 100644 --- a/generated/google-apis-firebasedynamiclinks_v1/CHANGELOG.md +++ b/generated/google-apis-firebasedynamiclinks_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebasedynamiclinks_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200905 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebasedynamiclinks_v1/OVERVIEW.md b/generated/google-apis-firebasedynamiclinks_v1/OVERVIEW.md index abf858a2a..2dccc7938 100644 --- a/generated/google-apis-firebasedynamiclinks_v1/OVERVIEW.md +++ b/generated/google-apis-firebasedynamiclinks_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Firebase Dynamic Links API +# Simple REST client for version V1 of the Firebase Dynamic Links API This is a simple client library for version V1 of the Firebase Dynamic Links API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Firebase Dynamic Links API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebasedynamiclinks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebasedynamiclinks service in particular.) For reference information on specific calls in the Firebase Dynamic Links API, see the {Google::Apis::FirebasedynamiclinksV1::FirebaseDynamicLinksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebasedynamiclinks_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebasedynamiclinks_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/dynamic-links/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebasedynamiclinks_v1/google-apis-firebasedynamiclinks_v1.gemspec b/generated/google-apis-firebasedynamiclinks_v1/google-apis-firebasedynamiclinks_v1.gemspec index 0666993cc..e331457f0 100644 --- a/generated/google-apis-firebasedynamiclinks_v1/google-apis-firebasedynamiclinks_v1.gemspec +++ b/generated/google-apis-firebasedynamiclinks_v1/google-apis-firebasedynamiclinks_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasedynamiclinksV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Dynamic Links API V1" + gem.summary = "Simple REST client for Firebase Dynamic Links API V1" gem.description = - "This is the legacy REST client for Firebase Dynamic Links API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Dynamic Links API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebasedynamiclinks_v1/lib/google/apis/firebasedynamiclinks_v1/gem_version.rb b/generated/google-apis-firebasedynamiclinks_v1/lib/google/apis/firebasedynamiclinks_v1/gem_version.rb index a7c02aa3d..5832e14ab 100644 --- a/generated/google-apis-firebasedynamiclinks_v1/lib/google/apis/firebasedynamiclinks_v1/gem_version.rb +++ b/generated/google-apis-firebasedynamiclinks_v1/lib/google/apis/firebasedynamiclinks_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200905" diff --git a/generated/google-apis-firebasehosting_v1/CHANGELOG.md b/generated/google-apis-firebasehosting_v1/CHANGELOG.md index 680d4f973..06ecff9b1 100644 --- a/generated/google-apis-firebasehosting_v1/CHANGELOG.md +++ b/generated/google-apis-firebasehosting_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebasehosting_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200731 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebasehosting_v1/OVERVIEW.md b/generated/google-apis-firebasehosting_v1/OVERVIEW.md index 1f23c19a7..f1a67ae85 100644 --- a/generated/google-apis-firebasehosting_v1/OVERVIEW.md +++ b/generated/google-apis-firebasehosting_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Firebase Hosting API +# Simple REST client for version V1 of the Firebase Hosting API This is a simple client library for version V1 of the Firebase Hosting API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Firebase Hosting API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebasehosting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebasehosting service in particular.) For reference information on specific calls in the Firebase Hosting API, see the {Google::Apis::FirebasehostingV1::FirebaseHostingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebasehosting_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebasehosting_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/hosting/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebasehosting_v1/google-apis-firebasehosting_v1.gemspec b/generated/google-apis-firebasehosting_v1/google-apis-firebasehosting_v1.gemspec index d3dbdae0a..1c353f794 100644 --- a/generated/google-apis-firebasehosting_v1/google-apis-firebasehosting_v1.gemspec +++ b/generated/google-apis-firebasehosting_v1/google-apis-firebasehosting_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasehostingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Hosting API V1" + gem.summary = "Simple REST client for Firebase Hosting API V1" gem.description = - "This is the legacy REST client for Firebase Hosting API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Hosting API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebasehosting_v1/lib/google/apis/firebasehosting_v1/gem_version.rb b/generated/google-apis-firebasehosting_v1/lib/google/apis/firebasehosting_v1/gem_version.rb index 7a82e2a0e..3ab1c7ea3 100644 --- a/generated/google-apis-firebasehosting_v1/lib/google/apis/firebasehosting_v1/gem_version.rb +++ b/generated/google-apis-firebasehosting_v1/lib/google/apis/firebasehosting_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200731" diff --git a/generated/google-apis-firebasehosting_v1beta1/CHANGELOG.md b/generated/google-apis-firebasehosting_v1beta1/CHANGELOG.md index fd96464c5..37753ee92 100644 --- a/generated/google-apis-firebasehosting_v1beta1/CHANGELOG.md +++ b/generated/google-apis-firebasehosting_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebasehosting_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201024 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebasehosting_v1beta1/OVERVIEW.md b/generated/google-apis-firebasehosting_v1beta1/OVERVIEW.md index 344772dbe..2eab391d7 100644 --- a/generated/google-apis-firebasehosting_v1beta1/OVERVIEW.md +++ b/generated/google-apis-firebasehosting_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Firebase Hosting API +# Simple REST client for version V1beta1 of the Firebase Hosting API This is a simple client library for version V1beta1 of the Firebase Hosting API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Firebase Hosting API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebasehosting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebasehosting service in particular.) For reference information on specific calls in the Firebase Hosting API, see the {Google::Apis::FirebasehostingV1beta1::FirebaseHostingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebasehosting_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebasehosting_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/hosting/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebasehosting_v1beta1/google-apis-firebasehosting_v1beta1.gemspec b/generated/google-apis-firebasehosting_v1beta1/google-apis-firebasehosting_v1beta1.gemspec index 8b75d01d5..a04933eda 100644 --- a/generated/google-apis-firebasehosting_v1beta1/google-apis-firebasehosting_v1beta1.gemspec +++ b/generated/google-apis-firebasehosting_v1beta1/google-apis-firebasehosting_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasehostingV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Hosting API V1beta1" + gem.summary = "Simple REST client for Firebase Hosting API V1beta1" gem.description = - "This is the legacy REST client for Firebase Hosting API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Hosting API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebasehosting_v1beta1/lib/google/apis/firebasehosting_v1beta1/gem_version.rb b/generated/google-apis-firebasehosting_v1beta1/lib/google/apis/firebasehosting_v1beta1/gem_version.rb index b7f372ead..b6ec70dad 100644 --- a/generated/google-apis-firebasehosting_v1beta1/lib/google/apis/firebasehosting_v1beta1/gem_version.rb +++ b/generated/google-apis-firebasehosting_v1beta1/lib/google/apis/firebasehosting_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201024" diff --git a/generated/google-apis-firebaseml_v1/CHANGELOG.md b/generated/google-apis-firebaseml_v1/CHANGELOG.md index 44e72e0f7..77e8cd398 100644 --- a/generated/google-apis-firebaseml_v1/CHANGELOG.md +++ b/generated/google-apis-firebaseml_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebaseml_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebaseml_v1/OVERVIEW.md b/generated/google-apis-firebaseml_v1/OVERVIEW.md index 224075a1e..ff20f6f5e 100644 --- a/generated/google-apis-firebaseml_v1/OVERVIEW.md +++ b/generated/google-apis-firebaseml_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Firebase ML API +# Simple REST client for version V1 of the Firebase ML API This is a simple client library for version V1 of the Firebase ML API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Firebase ML API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebaseml service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebaseml service in particular.) For reference information on specific calls in the Firebase ML API, see the {Google::Apis::FirebasemlV1::FirebaseMLService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebaseml_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebaseml_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebaseml_v1/google-apis-firebaseml_v1.gemspec b/generated/google-apis-firebaseml_v1/google-apis-firebaseml_v1.gemspec index 3b043f76a..ff89faf29 100644 --- a/generated/google-apis-firebaseml_v1/google-apis-firebaseml_v1.gemspec +++ b/generated/google-apis-firebaseml_v1/google-apis-firebaseml_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasemlV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase ML API V1" + gem.summary = "Simple REST client for Firebase ML API V1" gem.description = - "This is the legacy REST client for Firebase ML API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase ML API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebaseml_v1/lib/google/apis/firebaseml_v1/gem_version.rb b/generated/google-apis-firebaseml_v1/lib/google/apis/firebaseml_v1/gem_version.rb index f06e1c5c4..2c468822f 100644 --- a/generated/google-apis-firebaseml_v1/lib/google/apis/firebaseml_v1/gem_version.rb +++ b/generated/google-apis-firebaseml_v1/lib/google/apis/firebaseml_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-firebaseml_v1beta2/CHANGELOG.md b/generated/google-apis-firebaseml_v1beta2/CHANGELOG.md index 526cda095..ceae620ae 100644 --- a/generated/google-apis-firebaseml_v1beta2/CHANGELOG.md +++ b/generated/google-apis-firebaseml_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebaseml_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200905 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebaseml_v1beta2/OVERVIEW.md b/generated/google-apis-firebaseml_v1beta2/OVERVIEW.md index ea579ec98..577399705 100644 --- a/generated/google-apis-firebaseml_v1beta2/OVERVIEW.md +++ b/generated/google-apis-firebaseml_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Firebase ML API +# Simple REST client for version V1beta2 of the Firebase ML API This is a simple client library for version V1beta2 of the Firebase ML API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Firebase ML API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebaseml service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebaseml service in particular.) For reference information on specific calls in the Firebase ML API, see the {Google::Apis::FirebasemlV1beta2::FirebaseMLService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebaseml_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebaseml_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebaseml_v1beta2/google-apis-firebaseml_v1beta2.gemspec b/generated/google-apis-firebaseml_v1beta2/google-apis-firebaseml_v1beta2.gemspec index 7a2bf6983..f57869cc4 100644 --- a/generated/google-apis-firebaseml_v1beta2/google-apis-firebaseml_v1beta2.gemspec +++ b/generated/google-apis-firebaseml_v1beta2/google-apis-firebaseml_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebasemlV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase ML API V1beta2" + gem.summary = "Simple REST client for Firebase ML API V1beta2" gem.description = - "This is the legacy REST client for Firebase ML API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase ML API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebaseml_v1beta2/lib/google/apis/firebaseml_v1beta2/gem_version.rb b/generated/google-apis-firebaseml_v1beta2/lib/google/apis/firebaseml_v1beta2/gem_version.rb index 0d4e500f7..d302a9f44 100644 --- a/generated/google-apis-firebaseml_v1beta2/lib/google/apis/firebaseml_v1beta2/gem_version.rb +++ b/generated/google-apis-firebaseml_v1beta2/lib/google/apis/firebaseml_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200905" diff --git a/generated/google-apis-firebaserules_v1/CHANGELOG.md b/generated/google-apis-firebaserules_v1/CHANGELOG.md index deff864a6..b3f56697b 100644 --- a/generated/google-apis-firebaserules_v1/CHANGELOG.md +++ b/generated/google-apis-firebaserules_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firebaserules_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200807 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firebaserules_v1/OVERVIEW.md b/generated/google-apis-firebaserules_v1/OVERVIEW.md index a4ca79e23..77604ad6f 100644 --- a/generated/google-apis-firebaserules_v1/OVERVIEW.md +++ b/generated/google-apis-firebaserules_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Firebase Rules API +# Simple REST client for version V1 of the Firebase Rules API This is a simple client library for version V1 of the Firebase Rules API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Firebase Rules API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firebaserules service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firebaserules service in particular.) For reference information on specific calls in the Firebase Rules API, see the {Google::Apis::FirebaserulesV1::FirebaseRulesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firebaserules_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firebaserules_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/storage/security) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firebaserules_v1/google-apis-firebaserules_v1.gemspec b/generated/google-apis-firebaserules_v1/google-apis-firebaserules_v1.gemspec index a5d75f3e9..866d6b063 100644 --- a/generated/google-apis-firebaserules_v1/google-apis-firebaserules_v1.gemspec +++ b/generated/google-apis-firebaserules_v1/google-apis-firebaserules_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirebaserulesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Firebase Rules API V1" + gem.summary = "Simple REST client for Firebase Rules API V1" gem.description = - "This is the legacy REST client for Firebase Rules API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Firebase Rules API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firebaserules_v1/lib/google/apis/firebaserules_v1/gem_version.rb b/generated/google-apis-firebaserules_v1/lib/google/apis/firebaserules_v1/gem_version.rb index 2bd29d726..88a2751a7 100644 --- a/generated/google-apis-firebaserules_v1/lib/google/apis/firebaserules_v1/gem_version.rb +++ b/generated/google-apis-firebaserules_v1/lib/google/apis/firebaserules_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200807" diff --git a/generated/google-apis-firestore_v1/CHANGELOG.md b/generated/google-apis-firestore_v1/CHANGELOG.md index dafcb30d0..5ceba63cd 100644 --- a/generated/google-apis-firestore_v1/CHANGELOG.md +++ b/generated/google-apis-firestore_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firestore_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201016 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firestore_v1/OVERVIEW.md b/generated/google-apis-firestore_v1/OVERVIEW.md index e61bb59bf..062836d2f 100644 --- a/generated/google-apis-firestore_v1/OVERVIEW.md +++ b/generated/google-apis-firestore_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Firestore API +# Simple REST client for version V1 of the Cloud Firestore API This is a simple client library for version V1 of the Cloud Firestore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Firestore API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firestore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firestore service in particular.) For reference information on specific calls in the Cloud Firestore API, see the {Google::Apis::FirestoreV1::FirestoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firestore_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firestore_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/firestore) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firestore_v1/google-apis-firestore_v1.gemspec b/generated/google-apis-firestore_v1/google-apis-firestore_v1.gemspec index e649d8fc0..767940b61 100644 --- a/generated/google-apis-firestore_v1/google-apis-firestore_v1.gemspec +++ b/generated/google-apis-firestore_v1/google-apis-firestore_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirestoreV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Firestore API V1" + gem.summary = "Simple REST client for Cloud Firestore API V1" gem.description = - "This is the legacy REST client for Cloud Firestore API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Firestore API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firestore_v1/lib/google/apis/firestore_v1/gem_version.rb b/generated/google-apis-firestore_v1/lib/google/apis/firestore_v1/gem_version.rb index c212e6971..34daf2e5b 100644 --- a/generated/google-apis-firestore_v1/lib/google/apis/firestore_v1/gem_version.rb +++ b/generated/google-apis-firestore_v1/lib/google/apis/firestore_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201016" diff --git a/generated/google-apis-firestore_v1beta1/CHANGELOG.md b/generated/google-apis-firestore_v1beta1/CHANGELOG.md index 10cdb2e2e..fff0abbaf 100644 --- a/generated/google-apis-firestore_v1beta1/CHANGELOG.md +++ b/generated/google-apis-firestore_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firestore_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201017 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firestore_v1beta1/OVERVIEW.md b/generated/google-apis-firestore_v1beta1/OVERVIEW.md index cd934b19f..1da61ae3b 100644 --- a/generated/google-apis-firestore_v1beta1/OVERVIEW.md +++ b/generated/google-apis-firestore_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Firestore API +# Simple REST client for version V1beta1 of the Cloud Firestore API This is a simple client library for version V1beta1 of the Cloud Firestore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Firestore API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firestore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firestore service in particular.) For reference information on specific calls in the Cloud Firestore API, see the {Google::Apis::FirestoreV1beta1::FirestoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firestore_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firestore_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/firestore) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firestore_v1beta1/google-apis-firestore_v1beta1.gemspec b/generated/google-apis-firestore_v1beta1/google-apis-firestore_v1beta1.gemspec index 3ce0f8d46..45d55905e 100644 --- a/generated/google-apis-firestore_v1beta1/google-apis-firestore_v1beta1.gemspec +++ b/generated/google-apis-firestore_v1beta1/google-apis-firestore_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirestoreV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Firestore API V1beta1" + gem.summary = "Simple REST client for Cloud Firestore API V1beta1" gem.description = - "This is the legacy REST client for Cloud Firestore API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Firestore API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firestore_v1beta1/lib/google/apis/firestore_v1beta1/gem_version.rb b/generated/google-apis-firestore_v1beta1/lib/google/apis/firestore_v1beta1/gem_version.rb index 38927733c..f6ed75eea 100644 --- a/generated/google-apis-firestore_v1beta1/lib/google/apis/firestore_v1beta1/gem_version.rb +++ b/generated/google-apis-firestore_v1beta1/lib/google/apis/firestore_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201017" diff --git a/generated/google-apis-firestore_v1beta2/CHANGELOG.md b/generated/google-apis-firestore_v1beta2/CHANGELOG.md index a0bdefa84..89cf0482f 100644 --- a/generated/google-apis-firestore_v1beta2/CHANGELOG.md +++ b/generated/google-apis-firestore_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-firestore_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-firestore_v1beta2/OVERVIEW.md b/generated/google-apis-firestore_v1beta2/OVERVIEW.md index e38b109b0..f7d42ae3a 100644 --- a/generated/google-apis-firestore_v1beta2/OVERVIEW.md +++ b/generated/google-apis-firestore_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Firestore API +# Simple REST client for version V1beta2 of the Cloud Firestore API This is a simple client library for version V1beta2 of the Cloud Firestore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Firestore API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Firestore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Firestore service in particular.) For reference information on specific calls in the Cloud Firestore API, see the {Google::Apis::FirestoreV1beta2::FirestoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-firestore_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-firestore_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/firestore) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-firestore_v1beta2/google-apis-firestore_v1beta2.gemspec b/generated/google-apis-firestore_v1beta2/google-apis-firestore_v1beta2.gemspec index ecc3332bf..d143cd08c 100644 --- a/generated/google-apis-firestore_v1beta2/google-apis-firestore_v1beta2.gemspec +++ b/generated/google-apis-firestore_v1beta2/google-apis-firestore_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FirestoreV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Firestore API V1beta2" + gem.summary = "Simple REST client for Cloud Firestore API V1beta2" gem.description = - "This is the legacy REST client for Cloud Firestore API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Firestore API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-firestore_v1beta2/lib/google/apis/firestore_v1beta2/gem_version.rb b/generated/google-apis-firestore_v1beta2/lib/google/apis/firestore_v1beta2/gem_version.rb index 0cee25bae..787000fd5 100644 --- a/generated/google-apis-firestore_v1beta2/lib/google/apis/firestore_v1beta2/gem_version.rb +++ b/generated/google-apis-firestore_v1beta2/lib/google/apis/firestore_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-fitness_v1/CHANGELOG.md b/generated/google-apis-fitness_v1/CHANGELOG.md index 83926ee7a..179cfc331 100644 --- a/generated/google-apis-fitness_v1/CHANGELOG.md +++ b/generated/google-apis-fitness_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-fitness_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201012 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-fitness_v1/OVERVIEW.md b/generated/google-apis-fitness_v1/OVERVIEW.md index 24b1cd26e..570eb5103 100644 --- a/generated/google-apis-fitness_v1/OVERVIEW.md +++ b/generated/google-apis-fitness_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Fitness API +# Simple REST client for version V1 of the Fitness API This is a simple client library for version V1 of the Fitness API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Fitness API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Fitness service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Fitness service in particular.) For reference information on specific calls in the Fitness API, see the {Google::Apis::FitnessV1::FitnessService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-fitness_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-fitness_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/fit/rest/v1/get-started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-fitness_v1/google-apis-fitness_v1.gemspec b/generated/google-apis-fitness_v1/google-apis-fitness_v1.gemspec index 2f37390e7..12d39b285 100644 --- a/generated/google-apis-fitness_v1/google-apis-fitness_v1.gemspec +++ b/generated/google-apis-fitness_v1/google-apis-fitness_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::FitnessV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Fitness API V1" + gem.summary = "Simple REST client for Fitness API V1" gem.description = - "This is the legacy REST client for Fitness API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Fitness API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-fitness_v1/lib/google/apis/fitness_v1/gem_version.rb b/generated/google-apis-fitness_v1/lib/google/apis/fitness_v1/gem_version.rb index 210d48838..870379354 100644 --- a/generated/google-apis-fitness_v1/lib/google/apis/fitness_v1/gem_version.rb +++ b/generated/google-apis-fitness_v1/lib/google/apis/fitness_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201012" diff --git a/generated/google-apis-games_configuration_v1configuration/CHANGELOG.md b/generated/google-apis-games_configuration_v1configuration/CHANGELOG.md index d1a43545c..541fdd41e 100644 --- a/generated/google-apis-games_configuration_v1configuration/CHANGELOG.md +++ b/generated/google-apis-games_configuration_v1configuration/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-games_configuration_v1configuration -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200811 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-games_configuration_v1configuration/OVERVIEW.md b/generated/google-apis-games_configuration_v1configuration/OVERVIEW.md index adc07aa0d..dc0968e3c 100644 --- a/generated/google-apis-games_configuration_v1configuration/OVERVIEW.md +++ b/generated/google-apis-games_configuration_v1configuration/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1configuration of the Google Play Game Services Publishing API +# Simple REST client for version V1configuration of the Google Play Game Services Publishing API This is a simple client library for version V1configuration of the Google Play Game Services Publishing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1configuration of the Google Play G * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the GamesConfiguration service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the GamesConfiguration service in particular.) For reference information on specific calls in the Google Play Game Services Publishing API, see the {Google::Apis::GamesConfigurationV1configuration::GamesConfigurationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-games_configuration_v1configuration`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-games_configuration_v1configuration`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/games/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-games_configuration_v1configuration/google-apis-games_configuration_v1configuration.gemspec b/generated/google-apis-games_configuration_v1configuration/google-apis-games_configuration_v1configuration.gemspec index 13198f2dc..19261b12b 100644 --- a/generated/google-apis-games_configuration_v1configuration/google-apis-games_configuration_v1configuration.gemspec +++ b/generated/google-apis-games_configuration_v1configuration/google-apis-games_configuration_v1configuration.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GamesConfigurationV1configuration::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play Game Services Publishing API V1configuration" + gem.summary = "Simple REST client for Google Play Game Services Publishing API V1configuration" gem.description = - "This is the legacy REST client for Google Play Game Services Publishing API V1configuration." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play Game Services Publishing API V1configuration." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-games_configuration_v1configuration/lib/google/apis/games_configuration_v1configuration/gem_version.rb b/generated/google-apis-games_configuration_v1configuration/lib/google/apis/games_configuration_v1configuration/gem_version.rb index 6001d1061..134268836 100644 --- a/generated/google-apis-games_configuration_v1configuration/lib/google/apis/games_configuration_v1configuration/gem_version.rb +++ b/generated/google-apis-games_configuration_v1configuration/lib/google/apis/games_configuration_v1configuration/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200811" diff --git a/generated/google-apis-games_management_v1management/CHANGELOG.md b/generated/google-apis-games_management_v1management/CHANGELOG.md index 20bf05386..ef49b6740 100644 --- a/generated/google-apis-games_management_v1management/CHANGELOG.md +++ b/generated/google-apis-games_management_v1management/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-games_management_v1management -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200811 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-games_management_v1management/OVERVIEW.md b/generated/google-apis-games_management_v1management/OVERVIEW.md index 12224ad46..afc1b7e92 100644 --- a/generated/google-apis-games_management_v1management/OVERVIEW.md +++ b/generated/google-apis-games_management_v1management/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1management of the Google Play Game Management +# Simple REST client for version V1management of the Google Play Game Management This is a simple client library for version V1management of the Google Play Game Management. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1management of the Google Play Game * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the GamesManagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the GamesManagement service in particular.) For reference information on specific calls in the Google Play Game Management, see the {Google::Apis::GamesManagementV1management::GamesManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-games_management_v1management`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-games_management_v1management`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/games/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-games_management_v1management/google-apis-games_management_v1management.gemspec b/generated/google-apis-games_management_v1management/google-apis-games_management_v1management.gemspec index b8f9903f2..f7c8fc876 100644 --- a/generated/google-apis-games_management_v1management/google-apis-games_management_v1management.gemspec +++ b/generated/google-apis-games_management_v1management/google-apis-games_management_v1management.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GamesManagementV1management::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play Game Management V1management" + gem.summary = "Simple REST client for Google Play Game Management V1management" gem.description = - "This is the legacy REST client for Google Play Game Management V1management." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play Game Management V1management." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-games_management_v1management/lib/google/apis/games_management_v1management/gem_version.rb b/generated/google-apis-games_management_v1management/lib/google/apis/games_management_v1management/gem_version.rb index 58ffa29e0..cd506a015 100644 --- a/generated/google-apis-games_management_v1management/lib/google/apis/games_management_v1management/gem_version.rb +++ b/generated/google-apis-games_management_v1management/lib/google/apis/games_management_v1management/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200811" diff --git a/generated/google-apis-games_v1/CHANGELOG.md b/generated/google-apis-games_v1/CHANGELOG.md index ed607c2e7..c2562260c 100644 --- a/generated/google-apis-games_v1/CHANGELOG.md +++ b/generated/google-apis-games_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-games_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-games_v1/OVERVIEW.md b/generated/google-apis-games_v1/OVERVIEW.md index 2d030dbbc..976e2dc81 100644 --- a/generated/google-apis-games_v1/OVERVIEW.md +++ b/generated/google-apis-games_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Play Game Services +# Simple REST client for version V1 of the Google Play Game Services This is a simple client library for version V1 of the Google Play Game Services. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Play Game Services. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Games service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Games service in particular.) For reference information on specific calls in the Google Play Game Services, see the {Google::Apis::GamesV1::GamesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-games_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-games_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/games/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-games_v1/google-apis-games_v1.gemspec b/generated/google-apis-games_v1/google-apis-games_v1.gemspec index adb4b4798..d704f8f6c 100644 --- a/generated/google-apis-games_v1/google-apis-games_v1.gemspec +++ b/generated/google-apis-games_v1/google-apis-games_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GamesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play Game Services V1" + gem.summary = "Simple REST client for Google Play Game Services V1" gem.description = - "This is the legacy REST client for Google Play Game Services V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play Game Services V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-games_v1/lib/google/apis/games_v1/gem_version.rb b/generated/google-apis-games_v1/lib/google/apis/games_v1/gem_version.rb index c0a3f28b0..3932f1750 100644 --- a/generated/google-apis-games_v1/lib/google/apis/games_v1/gem_version.rb +++ b/generated/google-apis-games_v1/lib/google/apis/games_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-gameservices_v1/CHANGELOG.md b/generated/google-apis-gameservices_v1/CHANGELOG.md index 992320a5f..4ccc73546 100644 --- a/generated/google-apis-gameservices_v1/CHANGELOG.md +++ b/generated/google-apis-gameservices_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-gameservices_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-gameservices_v1/OVERVIEW.md b/generated/google-apis-gameservices_v1/OVERVIEW.md index 7d8dda8e5..ba72e7995 100644 --- a/generated/google-apis-gameservices_v1/OVERVIEW.md +++ b/generated/google-apis-gameservices_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Game Services API +# Simple REST client for version V1 of the Game Services API This is a simple client library for version V1 of the Game Services API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Game Services API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Gameservices service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Gameservices service in particular.) For reference information on specific calls in the Game Services API, see the {Google::Apis::GameservicesV1::GameServicesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-gameservices_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-gameservices_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/solutions/gaming/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-gameservices_v1/google-apis-gameservices_v1.gemspec b/generated/google-apis-gameservices_v1/google-apis-gameservices_v1.gemspec index 2b8b91cee..5f51c35cb 100644 --- a/generated/google-apis-gameservices_v1/google-apis-gameservices_v1.gemspec +++ b/generated/google-apis-gameservices_v1/google-apis-gameservices_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GameservicesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Game Services API V1" + gem.summary = "Simple REST client for Game Services API V1" gem.description = - "This is the legacy REST client for Game Services API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Game Services API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-gameservices_v1/lib/google/apis/gameservices_v1/gem_version.rb b/generated/google-apis-gameservices_v1/lib/google/apis/gameservices_v1/gem_version.rb index 44884b5ba..c6b96008c 100644 --- a/generated/google-apis-gameservices_v1/lib/google/apis/gameservices_v1/gem_version.rb +++ b/generated/google-apis-gameservices_v1/lib/google/apis/gameservices_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-gameservices_v1beta/CHANGELOG.md b/generated/google-apis-gameservices_v1beta/CHANGELOG.md index 042f6fb34..629caace6 100644 --- a/generated/google-apis-gameservices_v1beta/CHANGELOG.md +++ b/generated/google-apis-gameservices_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-gameservices_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-gameservices_v1beta/OVERVIEW.md b/generated/google-apis-gameservices_v1beta/OVERVIEW.md index 1bf0ff8b1..81659e90e 100644 --- a/generated/google-apis-gameservices_v1beta/OVERVIEW.md +++ b/generated/google-apis-gameservices_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Game Services API +# Simple REST client for version V1beta of the Game Services API This is a simple client library for version V1beta of the Game Services API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Game Services API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Gameservices service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Gameservices service in particular.) For reference information on specific calls in the Game Services API, see the {Google::Apis::GameservicesV1beta::GameServicesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-gameservices_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-gameservices_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/solutions/gaming/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-gameservices_v1beta/google-apis-gameservices_v1beta.gemspec b/generated/google-apis-gameservices_v1beta/google-apis-gameservices_v1beta.gemspec index 3bed26d89..c4bad7314 100644 --- a/generated/google-apis-gameservices_v1beta/google-apis-gameservices_v1beta.gemspec +++ b/generated/google-apis-gameservices_v1beta/google-apis-gameservices_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GameservicesV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Game Services API V1beta" + gem.summary = "Simple REST client for Game Services API V1beta" gem.description = - "This is the legacy REST client for Game Services API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Game Services API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-gameservices_v1beta/lib/google/apis/gameservices_v1beta/gem_version.rb b/generated/google-apis-gameservices_v1beta/lib/google/apis/gameservices_v1beta/gem_version.rb index 7d017d790..eefa3373b 100644 --- a/generated/google-apis-gameservices_v1beta/lib/google/apis/gameservices_v1beta/gem_version.rb +++ b/generated/google-apis-gameservices_v1beta/lib/google/apis/gameservices_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-genomics_v1/CHANGELOG.md b/generated/google-apis-genomics_v1/CHANGELOG.md index 1047821d7..39076d39e 100644 --- a/generated/google-apis-genomics_v1/CHANGELOG.md +++ b/generated/google-apis-genomics_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-genomics_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200804 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-genomics_v1/OVERVIEW.md b/generated/google-apis-genomics_v1/OVERVIEW.md index 108ca65c9..282b17c0d 100644 --- a/generated/google-apis-genomics_v1/OVERVIEW.md +++ b/generated/google-apis-genomics_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Genomics API +# Simple REST client for version V1 of the Genomics API This is a simple client library for version V1 of the Genomics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Genomics API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Genomics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Genomics service in particular.) For reference information on specific calls in the Genomics API, see the {Google::Apis::GenomicsV1::GenomicsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-genomics_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-genomics_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/genomics) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-genomics_v1/google-apis-genomics_v1.gemspec b/generated/google-apis-genomics_v1/google-apis-genomics_v1.gemspec index 6fb7a6647..36c94f09a 100644 --- a/generated/google-apis-genomics_v1/google-apis-genomics_v1.gemspec +++ b/generated/google-apis-genomics_v1/google-apis-genomics_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GenomicsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Genomics API V1" + gem.summary = "Simple REST client for Genomics API V1" gem.description = - "This is the legacy REST client for Genomics API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Genomics API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-genomics_v1/lib/google/apis/genomics_v1/gem_version.rb b/generated/google-apis-genomics_v1/lib/google/apis/genomics_v1/gem_version.rb index 7d29a913a..18b382f11 100644 --- a/generated/google-apis-genomics_v1/lib/google/apis/genomics_v1/gem_version.rb +++ b/generated/google-apis-genomics_v1/lib/google/apis/genomics_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200804" diff --git a/generated/google-apis-genomics_v1alpha2/CHANGELOG.md b/generated/google-apis-genomics_v1alpha2/CHANGELOG.md index 9c228f577..f4c1288fe 100644 --- a/generated/google-apis-genomics_v1alpha2/CHANGELOG.md +++ b/generated/google-apis-genomics_v1alpha2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-genomics_v1alpha2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200804 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-genomics_v1alpha2/OVERVIEW.md b/generated/google-apis-genomics_v1alpha2/OVERVIEW.md index 7d22fd28d..2c622ee2f 100644 --- a/generated/google-apis-genomics_v1alpha2/OVERVIEW.md +++ b/generated/google-apis-genomics_v1alpha2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha2 of the Genomics API +# Simple REST client for version V1alpha2 of the Genomics API This is a simple client library for version V1alpha2 of the Genomics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha2 of the Genomics API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Genomics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Genomics service in particular.) For reference information on specific calls in the Genomics API, see the {Google::Apis::GenomicsV1alpha2::GenomicsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-genomics_v1alpha2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-genomics_v1alpha2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/genomics) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-genomics_v1alpha2/google-apis-genomics_v1alpha2.gemspec b/generated/google-apis-genomics_v1alpha2/google-apis-genomics_v1alpha2.gemspec index 05c7da924..a65de2398 100644 --- a/generated/google-apis-genomics_v1alpha2/google-apis-genomics_v1alpha2.gemspec +++ b/generated/google-apis-genomics_v1alpha2/google-apis-genomics_v1alpha2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GenomicsV1alpha2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Genomics API V1alpha2" + gem.summary = "Simple REST client for Genomics API V1alpha2" gem.description = - "This is the legacy REST client for Genomics API V1alpha2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Genomics API V1alpha2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-genomics_v1alpha2/lib/google/apis/genomics_v1alpha2/gem_version.rb b/generated/google-apis-genomics_v1alpha2/lib/google/apis/genomics_v1alpha2/gem_version.rb index 80a827e78..e3b7a3743 100644 --- a/generated/google-apis-genomics_v1alpha2/lib/google/apis/genomics_v1alpha2/gem_version.rb +++ b/generated/google-apis-genomics_v1alpha2/lib/google/apis/genomics_v1alpha2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200804" diff --git a/generated/google-apis-genomics_v2alpha1/CHANGELOG.md b/generated/google-apis-genomics_v2alpha1/CHANGELOG.md index 81016054b..a042593d2 100644 --- a/generated/google-apis-genomics_v2alpha1/CHANGELOG.md +++ b/generated/google-apis-genomics_v2alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-genomics_v2alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20201231 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-genomics_v2alpha1/OVERVIEW.md b/generated/google-apis-genomics_v2alpha1/OVERVIEW.md index 0581664cb..7116c58f7 100644 --- a/generated/google-apis-genomics_v2alpha1/OVERVIEW.md +++ b/generated/google-apis-genomics_v2alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2alpha1 of the Genomics API +# Simple REST client for version V2alpha1 of the Genomics API This is a simple client library for version V2alpha1 of the Genomics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2alpha1 of the Genomics API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Genomics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Genomics service in particular.) For reference information on specific calls in the Genomics API, see the {Google::Apis::GenomicsV2alpha1::GenomicsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-genomics_v2alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-genomics_v2alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/genomics) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-genomics_v2alpha1/google-apis-genomics_v2alpha1.gemspec b/generated/google-apis-genomics_v2alpha1/google-apis-genomics_v2alpha1.gemspec index 110eb01a4..d0f29cc47 100644 --- a/generated/google-apis-genomics_v2alpha1/google-apis-genomics_v2alpha1.gemspec +++ b/generated/google-apis-genomics_v2alpha1/google-apis-genomics_v2alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GenomicsV2alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Genomics API V2alpha1" + gem.summary = "Simple REST client for Genomics API V2alpha1" gem.description = - "This is the legacy REST client for Genomics API V2alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Genomics API V2alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-genomics_v2alpha1/lib/google/apis/genomics_v2alpha1/gem_version.rb b/generated/google-apis-genomics_v2alpha1/lib/google/apis/genomics_v2alpha1/gem_version.rb index 016226043..458eafff8 100644 --- a/generated/google-apis-genomics_v2alpha1/lib/google/apis/genomics_v2alpha1/gem_version.rb +++ b/generated/google-apis-genomics_v2alpha1/lib/google/apis/genomics_v2alpha1/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201207" + REVISION = "20201231" end end end diff --git a/generated/google-apis-gmail_v1/CHANGELOG.md b/generated/google-apis-gmail_v1/CHANGELOG.md index b99973d39..aa3d05a54 100644 --- a/generated/google-apis-gmail_v1/CHANGELOG.md +++ b/generated/google-apis-gmail_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-gmail_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200919 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-gmail_v1/OVERVIEW.md b/generated/google-apis-gmail_v1/OVERVIEW.md index e5df44b0d..219e2ec0e 100644 --- a/generated/google-apis-gmail_v1/OVERVIEW.md +++ b/generated/google-apis-gmail_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Gmail API +# Simple REST client for version V1 of the Gmail API This is a simple client library for version V1 of the Gmail API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Gmail API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Gmail service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Gmail service in particular.) For reference information on specific calls in the Gmail API, see the {Google::Apis::GmailV1::GmailService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-gmail_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-gmail_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/gmail/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-gmail_v1/google-apis-gmail_v1.gemspec b/generated/google-apis-gmail_v1/google-apis-gmail_v1.gemspec index 99ec168f2..715eb23fc 100644 --- a/generated/google-apis-gmail_v1/google-apis-gmail_v1.gemspec +++ b/generated/google-apis-gmail_v1/google-apis-gmail_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GmailV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Gmail API V1" + gem.summary = "Simple REST client for Gmail API V1" gem.description = - "This is the legacy REST client for Gmail API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Gmail API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/gem_version.rb b/generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/gem_version.rb index 5d1ec3985..40289cf5f 100644 --- a/generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/gem_version.rb +++ b/generated/google-apis-gmail_v1/lib/google/apis/gmail_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200919" diff --git a/generated/google-apis-gmailpostmastertools_v1beta1/CHANGELOG.md b/generated/google-apis-gmailpostmastertools_v1beta1/CHANGELOG.md index 4ee6f4e46..e536dcab3 100644 --- a/generated/google-apis-gmailpostmastertools_v1beta1/CHANGELOG.md +++ b/generated/google-apis-gmailpostmastertools_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-gmailpostmastertools_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201123 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-gmailpostmastertools_v1beta1/OVERVIEW.md b/generated/google-apis-gmailpostmastertools_v1beta1/OVERVIEW.md index 95c0a3705..324a37f57 100644 --- a/generated/google-apis-gmailpostmastertools_v1beta1/OVERVIEW.md +++ b/generated/google-apis-gmailpostmastertools_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Gmail Postmaster Tools API +# Simple REST client for version V1beta1 of the Gmail Postmaster Tools API This is a simple client library for version V1beta1 of the Gmail Postmaster Tools API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Gmail Postmaster Tool * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Gmailpostmastertools service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Gmailpostmastertools service in particular.) For reference information on specific calls in the Gmail Postmaster Tools API, see the {Google::Apis::GmailpostmastertoolsV1beta1::PostmasterToolsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-gmailpostmastertools_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-gmailpostmastertools_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/gmail/postmaster) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-gmailpostmastertools_v1beta1/google-apis-gmailpostmastertools_v1beta1.gemspec b/generated/google-apis-gmailpostmastertools_v1beta1/google-apis-gmailpostmastertools_v1beta1.gemspec index 338b83a73..b966f9abe 100644 --- a/generated/google-apis-gmailpostmastertools_v1beta1/google-apis-gmailpostmastertools_v1beta1.gemspec +++ b/generated/google-apis-gmailpostmastertools_v1beta1/google-apis-gmailpostmastertools_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GmailpostmastertoolsV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Gmail Postmaster Tools API V1beta1" + gem.summary = "Simple REST client for Gmail Postmaster Tools API V1beta1" gem.description = - "This is the legacy REST client for Gmail Postmaster Tools API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Gmail Postmaster Tools API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-gmailpostmastertools_v1beta1/lib/google/apis/gmailpostmastertools_v1beta1/gem_version.rb b/generated/google-apis-gmailpostmastertools_v1beta1/lib/google/apis/gmailpostmastertools_v1beta1/gem_version.rb index e2c872e95..89b27637b 100644 --- a/generated/google-apis-gmailpostmastertools_v1beta1/lib/google/apis/gmailpostmastertools_v1beta1/gem_version.rb +++ b/generated/google-apis-gmailpostmastertools_v1beta1/lib/google/apis/gmailpostmastertools_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201123" diff --git a/generated/google-apis-groupsmigration_v1/CHANGELOG.md b/generated/google-apis-groupsmigration_v1/CHANGELOG.md index a7b031167..553ec0316 100644 --- a/generated/google-apis-groupsmigration_v1/CHANGELOG.md +++ b/generated/google-apis-groupsmigration_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-groupsmigration_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200820 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-groupsmigration_v1/OVERVIEW.md b/generated/google-apis-groupsmigration_v1/OVERVIEW.md index 49daa4243..681669271 100644 --- a/generated/google-apis-groupsmigration_v1/OVERVIEW.md +++ b/generated/google-apis-groupsmigration_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Groups Migration API +# Simple REST client for version V1 of the Groups Migration API This is a simple client library for version V1 of the Groups Migration API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Groups Migration API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Groupsmigration service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Groupsmigration service in particular.) For reference information on specific calls in the Groups Migration API, see the {Google::Apis::GroupsmigrationV1::GroupsMigrationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-groupsmigration_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-groupsmigration_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/google-apps/groups-migration/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-groupsmigration_v1/google-apis-groupsmigration_v1.gemspec b/generated/google-apis-groupsmigration_v1/google-apis-groupsmigration_v1.gemspec index 5f88e7e48..19f313170 100644 --- a/generated/google-apis-groupsmigration_v1/google-apis-groupsmigration_v1.gemspec +++ b/generated/google-apis-groupsmigration_v1/google-apis-groupsmigration_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GroupsmigrationV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Groups Migration API V1" + gem.summary = "Simple REST client for Groups Migration API V1" gem.description = - "This is the legacy REST client for Groups Migration API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Groups Migration API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-groupsmigration_v1/lib/google/apis/groupsmigration_v1/gem_version.rb b/generated/google-apis-groupsmigration_v1/lib/google/apis/groupsmigration_v1/gem_version.rb index 6d93b5197..3e415172d 100644 --- a/generated/google-apis-groupsmigration_v1/lib/google/apis/groupsmigration_v1/gem_version.rb +++ b/generated/google-apis-groupsmigration_v1/lib/google/apis/groupsmigration_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200820" diff --git a/generated/google-apis-groupssettings_v1/OVERVIEW.md b/generated/google-apis-groupssettings_v1/OVERVIEW.md index 26212972d..1726ee219 100644 --- a/generated/google-apis-groupssettings_v1/OVERVIEW.md +++ b/generated/google-apis-groupssettings_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Groups Settings API +# Simple REST client for version V1 of the Groups Settings API This is a simple client library for version V1 of the Groups Settings API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Groups Settings API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Groupssettings service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Groupssettings service in particular.) For reference information on specific calls in the Groups Settings API, see the {Google::Apis::GroupssettingsV1::GroupssettingsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-groupssettings_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-groupssettings_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/google-apps/groups-settings/get_started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-groupssettings_v1/google-apis-groupssettings_v1.gemspec b/generated/google-apis-groupssettings_v1/google-apis-groupssettings_v1.gemspec index 8a705f0e1..2c4156c5c 100644 --- a/generated/google-apis-groupssettings_v1/google-apis-groupssettings_v1.gemspec +++ b/generated/google-apis-groupssettings_v1/google-apis-groupssettings_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::GroupssettingsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Groups Settings API V1" + gem.summary = "Simple REST client for Groups Settings API V1" gem.description = - "This is the legacy REST client for Groups Settings API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Groups Settings API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-healthcare_v1/CHANGELOG.md b/generated/google-apis-healthcare_v1/CHANGELOG.md index 83efe0127..9ead9b879 100644 --- a/generated/google-apis-healthcare_v1/CHANGELOG.md +++ b/generated/google-apis-healthcare_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-healthcare_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-healthcare_v1/OVERVIEW.md b/generated/google-apis-healthcare_v1/OVERVIEW.md index 9164abfad..6fd68229e 100644 --- a/generated/google-apis-healthcare_v1/OVERVIEW.md +++ b/generated/google-apis-healthcare_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Healthcare API +# Simple REST client for version V1 of the Cloud Healthcare API This is a simple client library for version V1 of the Cloud Healthcare API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Healthcare API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Healthcare service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Healthcare service in particular.) For reference information on specific calls in the Cloud Healthcare API, see the {Google::Apis::HealthcareV1::CloudHealthcareService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-healthcare_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-healthcare_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/healthcare) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-healthcare_v1/google-apis-healthcare_v1.gemspec b/generated/google-apis-healthcare_v1/google-apis-healthcare_v1.gemspec index 9bb21b284..60528f843 100644 --- a/generated/google-apis-healthcare_v1/google-apis-healthcare_v1.gemspec +++ b/generated/google-apis-healthcare_v1/google-apis-healthcare_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::HealthcareV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Healthcare API V1" + gem.summary = "Simple REST client for Cloud Healthcare API V1" gem.description = - "This is the legacy REST client for Cloud Healthcare API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Healthcare API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-healthcare_v1/lib/google/apis/healthcare_v1/gem_version.rb b/generated/google-apis-healthcare_v1/lib/google/apis/healthcare_v1/gem_version.rb index cac87638a..b88c6920d 100644 --- a/generated/google-apis-healthcare_v1/lib/google/apis/healthcare_v1/gem_version.rb +++ b/generated/google-apis-healthcare_v1/lib/google/apis/healthcare_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-healthcare_v1beta1/CHANGELOG.md b/generated/google-apis-healthcare_v1beta1/CHANGELOG.md index 838342312..548ebcc1b 100644 --- a/generated/google-apis-healthcare_v1beta1/CHANGELOG.md +++ b/generated/google-apis-healthcare_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-healthcare_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-healthcare_v1beta1/OVERVIEW.md b/generated/google-apis-healthcare_v1beta1/OVERVIEW.md index a04f08beb..51d4c65f0 100644 --- a/generated/google-apis-healthcare_v1beta1/OVERVIEW.md +++ b/generated/google-apis-healthcare_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Healthcare API +# Simple REST client for version V1beta1 of the Cloud Healthcare API This is a simple client library for version V1beta1 of the Cloud Healthcare API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Healthcare API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Healthcare service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Healthcare service in particular.) For reference information on specific calls in the Cloud Healthcare API, see the {Google::Apis::HealthcareV1beta1::CloudHealthcareService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-healthcare_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-healthcare_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/healthcare) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-healthcare_v1beta1/google-apis-healthcare_v1beta1.gemspec b/generated/google-apis-healthcare_v1beta1/google-apis-healthcare_v1beta1.gemspec index f8ea31b17..84d8f1ed6 100644 --- a/generated/google-apis-healthcare_v1beta1/google-apis-healthcare_v1beta1.gemspec +++ b/generated/google-apis-healthcare_v1beta1/google-apis-healthcare_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::HealthcareV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Healthcare API V1beta1" + gem.summary = "Simple REST client for Cloud Healthcare API V1beta1" gem.description = - "This is the legacy REST client for Cloud Healthcare API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Healthcare API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-healthcare_v1beta1/lib/google/apis/healthcare_v1beta1/gem_version.rb b/generated/google-apis-healthcare_v1beta1/lib/google/apis/healthcare_v1beta1/gem_version.rb index 5bc120159..c6299428c 100644 --- a/generated/google-apis-healthcare_v1beta1/lib/google/apis/healthcare_v1beta1/gem_version.rb +++ b/generated/google-apis-healthcare_v1beta1/lib/google/apis/healthcare_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-homegraph_v1/CHANGELOG.md b/generated/google-apis-homegraph_v1/CHANGELOG.md index 2b04e62eb..32a7264ba 100644 --- a/generated/google-apis-homegraph_v1/CHANGELOG.md +++ b/generated/google-apis-homegraph_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-homegraph_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200827 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-homegraph_v1/OVERVIEW.md b/generated/google-apis-homegraph_v1/OVERVIEW.md index 21b6266d3..1ed695eb1 100644 --- a/generated/google-apis-homegraph_v1/OVERVIEW.md +++ b/generated/google-apis-homegraph_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the HomeGraph API +# Simple REST client for version V1 of the HomeGraph API This is a simple client library for version V1 of the HomeGraph API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the HomeGraph API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Homegraph service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Homegraph service in particular.) For reference information on specific calls in the HomeGraph API, see the {Google::Apis::HomegraphV1::HomeGraphServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-homegraph_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-homegraph_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/actions/smarthome/create-app#request-sync) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-homegraph_v1/google-apis-homegraph_v1.gemspec b/generated/google-apis-homegraph_v1/google-apis-homegraph_v1.gemspec index 3468abbf7..61c47b54c 100644 --- a/generated/google-apis-homegraph_v1/google-apis-homegraph_v1.gemspec +++ b/generated/google-apis-homegraph_v1/google-apis-homegraph_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::HomegraphV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for HomeGraph API V1" + gem.summary = "Simple REST client for HomeGraph API V1" gem.description = - "This is the legacy REST client for HomeGraph API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for HomeGraph API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-homegraph_v1/lib/google/apis/homegraph_v1/gem_version.rb b/generated/google-apis-homegraph_v1/lib/google/apis/homegraph_v1/gem_version.rb index 5ec3b61ba..aa0788366 100644 --- a/generated/google-apis-homegraph_v1/lib/google/apis/homegraph_v1/gem_version.rb +++ b/generated/google-apis-homegraph_v1/lib/google/apis/homegraph_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200827" diff --git a/generated/google-apis-iam_v1/CHANGELOG.md b/generated/google-apis-iam_v1/CHANGELOG.md index 03d4790dc..7e7e11ea9 100644 --- a/generated/google-apis-iam_v1/CHANGELOG.md +++ b/generated/google-apis-iam_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-iam_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-iam_v1/OVERVIEW.md b/generated/google-apis-iam_v1/OVERVIEW.md index e907e17e5..eebfb3a83 100644 --- a/generated/google-apis-iam_v1/OVERVIEW.md +++ b/generated/google-apis-iam_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Identity and Access Management (IAM) API +# Simple REST client for version V1 of the Identity and Access Management (IAM) API This is a simple client library for version V1 of the Identity and Access Management (IAM) API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Identity and Access Manage * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Iam service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Iam service in particular.) For reference information on specific calls in the Identity and Access Management (IAM) API, see the {Google::Apis::IamV1::IamService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-iam_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-iam_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iam/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-iam_v1/google-apis-iam_v1.gemspec b/generated/google-apis-iam_v1/google-apis-iam_v1.gemspec index a90b22459..56c0def0e 100644 --- a/generated/google-apis-iam_v1/google-apis-iam_v1.gemspec +++ b/generated/google-apis-iam_v1/google-apis-iam_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IamV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Identity and Access Management (IAM) API V1" + gem.summary = "Simple REST client for Identity and Access Management (IAM) API V1" gem.description = - "This is the legacy REST client for Identity and Access Management (IAM) API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Identity and Access Management (IAM) API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-iam_v1/lib/google/apis/iam_v1/gem_version.rb b/generated/google-apis-iam_v1/lib/google/apis/iam_v1/gem_version.rb index 218830fcb..05f6ca361 100644 --- a/generated/google-apis-iam_v1/lib/google/apis/iam_v1/gem_version.rb +++ b/generated/google-apis-iam_v1/lib/google/apis/iam_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-iamcredentials_v1/CHANGELOG.md b/generated/google-apis-iamcredentials_v1/CHANGELOG.md index 369ddb0c4..878e06922 100644 --- a/generated/google-apis-iamcredentials_v1/CHANGELOG.md +++ b/generated/google-apis-iamcredentials_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-iamcredentials_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201022 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-iamcredentials_v1/OVERVIEW.md b/generated/google-apis-iamcredentials_v1/OVERVIEW.md index d82f4498b..b841bc01e 100644 --- a/generated/google-apis-iamcredentials_v1/OVERVIEW.md +++ b/generated/google-apis-iamcredentials_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the IAM Service Account Credentials API +# Simple REST client for version V1 of the IAM Service Account Credentials API This is a simple client library for version V1 of the IAM Service Account Credentials API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the IAM Service Account Creden * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Iamcredentials service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Iamcredentials service in particular.) For reference information on specific calls in the IAM Service Account Credentials API, see the {Google::Apis::IamcredentialsV1::IAMCredentialsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-iamcredentials_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-iamcredentials_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iam/docs/creating-short-lived-service-account-credentials) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-iamcredentials_v1/google-apis-iamcredentials_v1.gemspec b/generated/google-apis-iamcredentials_v1/google-apis-iamcredentials_v1.gemspec index 81142a330..3ce0672b0 100644 --- a/generated/google-apis-iamcredentials_v1/google-apis-iamcredentials_v1.gemspec +++ b/generated/google-apis-iamcredentials_v1/google-apis-iamcredentials_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IamcredentialsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for IAM Service Account Credentials API V1" + gem.summary = "Simple REST client for IAM Service Account Credentials API V1" gem.description = - "This is the legacy REST client for IAM Service Account Credentials API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for IAM Service Account Credentials API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-iamcredentials_v1/lib/google/apis/iamcredentials_v1/gem_version.rb b/generated/google-apis-iamcredentials_v1/lib/google/apis/iamcredentials_v1/gem_version.rb index 7bdfa415d..841ff9506 100644 --- a/generated/google-apis-iamcredentials_v1/lib/google/apis/iamcredentials_v1/gem_version.rb +++ b/generated/google-apis-iamcredentials_v1/lib/google/apis/iamcredentials_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201022" diff --git a/generated/google-apis-iap_v1/CHANGELOG.md b/generated/google-apis-iap_v1/CHANGELOG.md index e9dbc02f2..ae625e356 100644 --- a/generated/google-apis-iap_v1/CHANGELOG.md +++ b/generated/google-apis-iap_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-iap_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-iap_v1/OVERVIEW.md b/generated/google-apis-iap_v1/OVERVIEW.md index ad9c81bd8..38ddb9fcc 100644 --- a/generated/google-apis-iap_v1/OVERVIEW.md +++ b/generated/google-apis-iap_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Identity-Aware Proxy API +# Simple REST client for version V1 of the Cloud Identity-Aware Proxy API This is a simple client library for version V1 of the Cloud Identity-Aware Proxy API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Identity-Aware Proxy * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Iap service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Iap service in particular.) For reference information on specific calls in the Cloud Identity-Aware Proxy API, see the {Google::Apis::IapV1::CloudIAPService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-iap_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-iap_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iap) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-iap_v1/google-apis-iap_v1.gemspec b/generated/google-apis-iap_v1/google-apis-iap_v1.gemspec index 245c6d60e..acd3110de 100644 --- a/generated/google-apis-iap_v1/google-apis-iap_v1.gemspec +++ b/generated/google-apis-iap_v1/google-apis-iap_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IapV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Identity-Aware Proxy API V1" + gem.summary = "Simple REST client for Cloud Identity-Aware Proxy API V1" gem.description = - "This is the legacy REST client for Cloud Identity-Aware Proxy API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Identity-Aware Proxy API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-iap_v1/lib/google/apis/iap_v1/gem_version.rb b/generated/google-apis-iap_v1/lib/google/apis/iap_v1/gem_version.rb index eab22cbbd..4e65516d5 100644 --- a/generated/google-apis-iap_v1/lib/google/apis/iap_v1/gem_version.rb +++ b/generated/google-apis-iap_v1/lib/google/apis/iap_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-iap_v1beta1/CHANGELOG.md b/generated/google-apis-iap_v1beta1/CHANGELOG.md index 78f64a6d5..852f8a1ea 100644 --- a/generated/google-apis-iap_v1beta1/CHANGELOG.md +++ b/generated/google-apis-iap_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-iap_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-iap_v1beta1/OVERVIEW.md b/generated/google-apis-iap_v1beta1/OVERVIEW.md index ce50fbc4e..a7bd7f316 100644 --- a/generated/google-apis-iap_v1beta1/OVERVIEW.md +++ b/generated/google-apis-iap_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Identity-Aware Proxy API +# Simple REST client for version V1beta1 of the Cloud Identity-Aware Proxy API This is a simple client library for version V1beta1 of the Cloud Identity-Aware Proxy API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Identity-Aware * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Iap service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Iap service in particular.) For reference information on specific calls in the Cloud Identity-Aware Proxy API, see the {Google::Apis::IapV1beta1::CloudIAPService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-iap_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-iap_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iap) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-iap_v1beta1/google-apis-iap_v1beta1.gemspec b/generated/google-apis-iap_v1beta1/google-apis-iap_v1beta1.gemspec index b8df1aaf9..72a58a3b3 100644 --- a/generated/google-apis-iap_v1beta1/google-apis-iap_v1beta1.gemspec +++ b/generated/google-apis-iap_v1beta1/google-apis-iap_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IapV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Identity-Aware Proxy API V1beta1" + gem.summary = "Simple REST client for Cloud Identity-Aware Proxy API V1beta1" gem.description = - "This is the legacy REST client for Cloud Identity-Aware Proxy API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Identity-Aware Proxy API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-iap_v1beta1/lib/google/apis/iap_v1beta1/gem_version.rb b/generated/google-apis-iap_v1beta1/lib/google/apis/iap_v1beta1/gem_version.rb index ef244647d..a6d67fe0e 100644 --- a/generated/google-apis-iap_v1beta1/lib/google/apis/iap_v1beta1/gem_version.rb +++ b/generated/google-apis-iap_v1beta1/lib/google/apis/iap_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-identitytoolkit_v3/CHANGELOG.md b/generated/google-apis-identitytoolkit_v3/CHANGELOG.md index 3ffd7bbe8..1410de37a 100644 --- a/generated/google-apis-identitytoolkit_v3/CHANGELOG.md +++ b/generated/google-apis-identitytoolkit_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-identitytoolkit_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20180723 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-identitytoolkit_v3/OVERVIEW.md b/generated/google-apis-identitytoolkit_v3/OVERVIEW.md index 497c90ca7..dd6e0946e 100644 --- a/generated/google-apis-identitytoolkit_v3/OVERVIEW.md +++ b/generated/google-apis-identitytoolkit_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Google Identity Toolkit API +# Simple REST client for version V3 of the Google Identity Toolkit API This is a simple client library for version V3 of the Google Identity Toolkit API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Google Identity Toolkit AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Identitytoolkit service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Identitytoolkit service in particular.) For reference information on specific calls in the Google Identity Toolkit API, see the {Google::Apis::IdentitytoolkitV3::IdentityToolkitService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-identitytoolkit_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-identitytoolkit_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/identity-toolkit/v3/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-identitytoolkit_v3/google-apis-identitytoolkit_v3.gemspec b/generated/google-apis-identitytoolkit_v3/google-apis-identitytoolkit_v3.gemspec index c8ad11fb2..f2c951950 100644 --- a/generated/google-apis-identitytoolkit_v3/google-apis-identitytoolkit_v3.gemspec +++ b/generated/google-apis-identitytoolkit_v3/google-apis-identitytoolkit_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IdentitytoolkitV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Identity Toolkit API V3" + gem.summary = "Simple REST client for Google Identity Toolkit API V3" gem.description = - "This is the legacy REST client for Google Identity Toolkit API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Identity Toolkit API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-identitytoolkit_v3/lib/google/apis/identitytoolkit_v3/gem_version.rb b/generated/google-apis-identitytoolkit_v3/lib/google/apis/identitytoolkit_v3/gem_version.rb index 58862a73d..36bef3d52 100644 --- a/generated/google-apis-identitytoolkit_v3/lib/google/apis/identitytoolkit_v3/gem_version.rb +++ b/generated/google-apis-identitytoolkit_v3/lib/google/apis/identitytoolkit_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20180723" diff --git a/generated/google-apis-indexing_v3/CHANGELOG.md b/generated/google-apis-indexing_v3/CHANGELOG.md index ca78a2a2c..4e5fbaf20 100644 --- a/generated/google-apis-indexing_v3/CHANGELOG.md +++ b/generated/google-apis-indexing_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-indexing_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200804 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-indexing_v3/OVERVIEW.md b/generated/google-apis-indexing_v3/OVERVIEW.md index 6abc1fb83..5fb395a89 100644 --- a/generated/google-apis-indexing_v3/OVERVIEW.md +++ b/generated/google-apis-indexing_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Indexing API +# Simple REST client for version V3 of the Indexing API This is a simple client library for version V3 of the Indexing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Indexing API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Indexing service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Indexing service in particular.) For reference information on specific calls in the Indexing API, see the {Google::Apis::IndexingV3::IndexingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-indexing_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-indexing_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/search/apis/indexing-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-indexing_v3/google-apis-indexing_v3.gemspec b/generated/google-apis-indexing_v3/google-apis-indexing_v3.gemspec index da47696c6..2b47d4476 100644 --- a/generated/google-apis-indexing_v3/google-apis-indexing_v3.gemspec +++ b/generated/google-apis-indexing_v3/google-apis-indexing_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::IndexingV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Indexing API V3" + gem.summary = "Simple REST client for Indexing API V3" gem.description = - "This is the legacy REST client for Indexing API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Indexing API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-indexing_v3/lib/google/apis/indexing_v3/gem_version.rb b/generated/google-apis-indexing_v3/lib/google/apis/indexing_v3/gem_version.rb index d83892589..042c89517 100644 --- a/generated/google-apis-indexing_v3/lib/google/apis/indexing_v3/gem_version.rb +++ b/generated/google-apis-indexing_v3/lib/google/apis/indexing_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200804" diff --git a/generated/google-apis-jobs_v3/CHANGELOG.md b/generated/google-apis-jobs_v3/CHANGELOG.md index 0f11ca0d2..6a0b2d310 100644 --- a/generated/google-apis-jobs_v3/CHANGELOG.md +++ b/generated/google-apis-jobs_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-jobs_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201124 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-jobs_v3/OVERVIEW.md b/generated/google-apis-jobs_v3/OVERVIEW.md index b8a01f73f..2aa3ea222 100644 --- a/generated/google-apis-jobs_v3/OVERVIEW.md +++ b/generated/google-apis-jobs_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Cloud Talent Solution API +# Simple REST client for version V3 of the Cloud Talent Solution API This is a simple client library for version V3 of the Cloud Talent Solution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Cloud Talent Solution API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Jobs service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Jobs service in particular.) For reference information on specific calls in the Cloud Talent Solution API, see the {Google::Apis::JobsV3::CloudTalentSolutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-jobs_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-jobs_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/talent-solution/job-search/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-jobs_v3/google-apis-jobs_v3.gemspec b/generated/google-apis-jobs_v3/google-apis-jobs_v3.gemspec index 8e3c429c1..547ac3dae 100644 --- a/generated/google-apis-jobs_v3/google-apis-jobs_v3.gemspec +++ b/generated/google-apis-jobs_v3/google-apis-jobs_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::JobsV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Talent Solution API V3" + gem.summary = "Simple REST client for Cloud Talent Solution API V3" gem.description = - "This is the legacy REST client for Cloud Talent Solution API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Talent Solution API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/gem_version.rb b/generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/gem_version.rb index ede5f8e12..bb964cd74 100644 --- a/generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/gem_version.rb +++ b/generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201124" diff --git a/generated/google-apis-jobs_v3p1beta1/CHANGELOG.md b/generated/google-apis-jobs_v3p1beta1/CHANGELOG.md index 2c0fc1c3d..6af66d399 100644 --- a/generated/google-apis-jobs_v3p1beta1/CHANGELOG.md +++ b/generated/google-apis-jobs_v3p1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-jobs_v3p1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201124 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-jobs_v3p1beta1/OVERVIEW.md b/generated/google-apis-jobs_v3p1beta1/OVERVIEW.md index c94dbece6..2da6fa737 100644 --- a/generated/google-apis-jobs_v3p1beta1/OVERVIEW.md +++ b/generated/google-apis-jobs_v3p1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3p1beta1 of the Cloud Talent Solution API +# Simple REST client for version V3p1beta1 of the Cloud Talent Solution API This is a simple client library for version V3p1beta1 of the Cloud Talent Solution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3p1beta1 of the Cloud Talent Soluti * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Jobs service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Jobs service in particular.) For reference information on specific calls in the Cloud Talent Solution API, see the {Google::Apis::JobsV3p1beta1::CloudTalentSolutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-jobs_v3p1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-jobs_v3p1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/talent-solution/job-search/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-jobs_v3p1beta1/google-apis-jobs_v3p1beta1.gemspec b/generated/google-apis-jobs_v3p1beta1/google-apis-jobs_v3p1beta1.gemspec index 0e8e97402..a57ac7e43 100644 --- a/generated/google-apis-jobs_v3p1beta1/google-apis-jobs_v3p1beta1.gemspec +++ b/generated/google-apis-jobs_v3p1beta1/google-apis-jobs_v3p1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::JobsV3p1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Talent Solution API V3p1beta1" + gem.summary = "Simple REST client for Cloud Talent Solution API V3p1beta1" gem.description = - "This is the legacy REST client for Cloud Talent Solution API V3p1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Talent Solution API V3p1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-jobs_v3p1beta1/lib/google/apis/jobs_v3p1beta1/gem_version.rb b/generated/google-apis-jobs_v3p1beta1/lib/google/apis/jobs_v3p1beta1/gem_version.rb index 082390bed..4041079b8 100644 --- a/generated/google-apis-jobs_v3p1beta1/lib/google/apis/jobs_v3p1beta1/gem_version.rb +++ b/generated/google-apis-jobs_v3p1beta1/lib/google/apis/jobs_v3p1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201124" diff --git a/generated/google-apis-jobs_v4/CHANGELOG.md b/generated/google-apis-jobs_v4/CHANGELOG.md index 734fc741b..c901090b9 100644 --- a/generated/google-apis-jobs_v4/CHANGELOG.md +++ b/generated/google-apis-jobs_v4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-jobs_v4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201124 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-jobs_v4/OVERVIEW.md b/generated/google-apis-jobs_v4/OVERVIEW.md index 416226fc9..94f28f265 100644 --- a/generated/google-apis-jobs_v4/OVERVIEW.md +++ b/generated/google-apis-jobs_v4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V4 of the Cloud Talent Solution API +# Simple REST client for version V4 of the Cloud Talent Solution API This is a simple client library for version V4 of the Cloud Talent Solution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V4 of the Cloud Talent Solution API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Jobs service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Jobs service in particular.) For reference information on specific calls in the Cloud Talent Solution API, see the {Google::Apis::JobsV4::CloudTalentSolutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-jobs_v4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-jobs_v4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/talent-solution/job-search/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-jobs_v4/google-apis-jobs_v4.gemspec b/generated/google-apis-jobs_v4/google-apis-jobs_v4.gemspec index 724880827..e22082bb0 100644 --- a/generated/google-apis-jobs_v4/google-apis-jobs_v4.gemspec +++ b/generated/google-apis-jobs_v4/google-apis-jobs_v4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::JobsV4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Talent Solution API V4" + gem.summary = "Simple REST client for Cloud Talent Solution API V4" gem.description = - "This is the legacy REST client for Cloud Talent Solution API V4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Talent Solution API V4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-jobs_v4/lib/google/apis/jobs_v4/gem_version.rb b/generated/google-apis-jobs_v4/lib/google/apis/jobs_v4/gem_version.rb index 3cc1802bd..f588836ec 100644 --- a/generated/google-apis-jobs_v4/lib/google/apis/jobs_v4/gem_version.rb +++ b/generated/google-apis-jobs_v4/lib/google/apis/jobs_v4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201124" diff --git a/generated/google-apis-kgsearch_v1/CHANGELOG.md b/generated/google-apis-kgsearch_v1/CHANGELOG.md index cb99307d2..3135a5ed3 100644 --- a/generated/google-apis-kgsearch_v1/CHANGELOG.md +++ b/generated/google-apis-kgsearch_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-kgsearch_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200809 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-kgsearch_v1/OVERVIEW.md b/generated/google-apis-kgsearch_v1/OVERVIEW.md index 3dbc44917..1ae1a17ee 100644 --- a/generated/google-apis-kgsearch_v1/OVERVIEW.md +++ b/generated/google-apis-kgsearch_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Knowledge Graph Search API +# Simple REST client for version V1 of the Knowledge Graph Search API This is a simple client library for version V1 of the Knowledge Graph Search API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Knowledge Graph Search API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Kgsearch service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Kgsearch service in particular.) For reference information on specific calls in the Knowledge Graph Search API, see the {Google::Apis::KgsearchV1::KgsearchService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-kgsearch_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-kgsearch_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/knowledge-graph/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-kgsearch_v1/google-apis-kgsearch_v1.gemspec b/generated/google-apis-kgsearch_v1/google-apis-kgsearch_v1.gemspec index 16bd9748c..f59a6d931 100644 --- a/generated/google-apis-kgsearch_v1/google-apis-kgsearch_v1.gemspec +++ b/generated/google-apis-kgsearch_v1/google-apis-kgsearch_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::KgsearchV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Knowledge Graph Search API V1" + gem.summary = "Simple REST client for Knowledge Graph Search API V1" gem.description = - "This is the legacy REST client for Knowledge Graph Search API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Knowledge Graph Search API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-kgsearch_v1/lib/google/apis/kgsearch_v1/gem_version.rb b/generated/google-apis-kgsearch_v1/lib/google/apis/kgsearch_v1/gem_version.rb index 10a0e9fc1..4a035b3b1 100644 --- a/generated/google-apis-kgsearch_v1/lib/google/apis/kgsearch_v1/gem_version.rb +++ b/generated/google-apis-kgsearch_v1/lib/google/apis/kgsearch_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200809" diff --git a/generated/google-apis-language_v1/CHANGELOG.md b/generated/google-apis-language_v1/CHANGELOG.md index 5c1a86e89..e67326919 100644 --- a/generated/google-apis-language_v1/CHANGELOG.md +++ b/generated/google-apis-language_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-language_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-language_v1/OVERVIEW.md b/generated/google-apis-language_v1/OVERVIEW.md index d5c704f96..33511d43f 100644 --- a/generated/google-apis-language_v1/OVERVIEW.md +++ b/generated/google-apis-language_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Natural Language API +# Simple REST client for version V1 of the Cloud Natural Language API This is a simple client library for version V1 of the Cloud Natural Language API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Natural Language API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Language service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Language service in particular.) For reference information on specific calls in the Cloud Natural Language API, see the {Google::Apis::LanguageV1::CloudNaturalLanguageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-language_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-language_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/natural-language/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-language_v1/google-apis-language_v1.gemspec b/generated/google-apis-language_v1/google-apis-language_v1.gemspec index cff56306e..88ae8a581 100644 --- a/generated/google-apis-language_v1/google-apis-language_v1.gemspec +++ b/generated/google-apis-language_v1/google-apis-language_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LanguageV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Natural Language API V1" + gem.summary = "Simple REST client for Cloud Natural Language API V1" gem.description = - "This is the legacy REST client for Cloud Natural Language API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Natural Language API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-language_v1/lib/google/apis/language_v1/gem_version.rb b/generated/google-apis-language_v1/lib/google/apis/language_v1/gem_version.rb index 81451d6c9..a0eb11b12 100644 --- a/generated/google-apis-language_v1/lib/google/apis/language_v1/gem_version.rb +++ b/generated/google-apis-language_v1/lib/google/apis/language_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-language_v1beta1/CHANGELOG.md b/generated/google-apis-language_v1beta1/CHANGELOG.md index 9f8f63068..5c346dcfe 100644 --- a/generated/google-apis-language_v1beta1/CHANGELOG.md +++ b/generated/google-apis-language_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-language_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-language_v1beta1/OVERVIEW.md b/generated/google-apis-language_v1beta1/OVERVIEW.md index 0257a752c..b26d23f43 100644 --- a/generated/google-apis-language_v1beta1/OVERVIEW.md +++ b/generated/google-apis-language_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Natural Language API +# Simple REST client for version V1beta1 of the Cloud Natural Language API This is a simple client library for version V1beta1 of the Cloud Natural Language API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Natural Languag * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Language service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Language service in particular.) For reference information on specific calls in the Cloud Natural Language API, see the {Google::Apis::LanguageV1beta1::CloudNaturalLanguageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-language_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-language_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/natural-language/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-language_v1beta1/google-apis-language_v1beta1.gemspec b/generated/google-apis-language_v1beta1/google-apis-language_v1beta1.gemspec index 0cafdeb1c..f691ac954 100644 --- a/generated/google-apis-language_v1beta1/google-apis-language_v1beta1.gemspec +++ b/generated/google-apis-language_v1beta1/google-apis-language_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LanguageV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Natural Language API V1beta1" + gem.summary = "Simple REST client for Cloud Natural Language API V1beta1" gem.description = - "This is the legacy REST client for Cloud Natural Language API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Natural Language API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-language_v1beta1/lib/google/apis/language_v1beta1/gem_version.rb b/generated/google-apis-language_v1beta1/lib/google/apis/language_v1beta1/gem_version.rb index 0e9044fef..d81d21f69 100644 --- a/generated/google-apis-language_v1beta1/lib/google/apis/language_v1beta1/gem_version.rb +++ b/generated/google-apis-language_v1beta1/lib/google/apis/language_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-language_v1beta2/CHANGELOG.md b/generated/google-apis-language_v1beta2/CHANGELOG.md index a874119d5..e019db344 100644 --- a/generated/google-apis-language_v1beta2/CHANGELOG.md +++ b/generated/google-apis-language_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-language_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-language_v1beta2/OVERVIEW.md b/generated/google-apis-language_v1beta2/OVERVIEW.md index b62c53009..d8ade4502 100644 --- a/generated/google-apis-language_v1beta2/OVERVIEW.md +++ b/generated/google-apis-language_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Natural Language API +# Simple REST client for version V1beta2 of the Cloud Natural Language API This is a simple client library for version V1beta2 of the Cloud Natural Language API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Natural Languag * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Language service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Language service in particular.) For reference information on specific calls in the Cloud Natural Language API, see the {Google::Apis::LanguageV1beta2::CloudNaturalLanguageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-language_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-language_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/natural-language/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-language_v1beta2/google-apis-language_v1beta2.gemspec b/generated/google-apis-language_v1beta2/google-apis-language_v1beta2.gemspec index cebe35a06..28f96d468 100644 --- a/generated/google-apis-language_v1beta2/google-apis-language_v1beta2.gemspec +++ b/generated/google-apis-language_v1beta2/google-apis-language_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LanguageV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Natural Language API V1beta2" + gem.summary = "Simple REST client for Cloud Natural Language API V1beta2" gem.description = - "This is the legacy REST client for Cloud Natural Language API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Natural Language API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-language_v1beta2/lib/google/apis/language_v1beta2/gem_version.rb b/generated/google-apis-language_v1beta2/lib/google/apis/language_v1beta2/gem_version.rb index 505353192..23c6170bd 100644 --- a/generated/google-apis-language_v1beta2/lib/google/apis/language_v1beta2/gem_version.rb +++ b/generated/google-apis-language_v1beta2/lib/google/apis/language_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-libraryagent_v1/CHANGELOG.md b/generated/google-apis-libraryagent_v1/CHANGELOG.md index 6f5066926..b8734ebf1 100644 --- a/generated/google-apis-libraryagent_v1/CHANGELOG.md +++ b/generated/google-apis-libraryagent_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-libraryagent_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-libraryagent_v1/OVERVIEW.md b/generated/google-apis-libraryagent_v1/OVERVIEW.md index e5382cb06..892c86c27 100644 --- a/generated/google-apis-libraryagent_v1/OVERVIEW.md +++ b/generated/google-apis-libraryagent_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Library Agent API +# Simple REST client for version V1 of the Library Agent API This is a simple client library for version V1 of the Library Agent API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Library Agent API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Libraryagent service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Libraryagent service in particular.) For reference information on specific calls in the Library Agent API, see the {Google::Apis::LibraryagentV1::LibraryagentService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-libraryagent_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-libraryagent_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/docs/quota) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-libraryagent_v1/google-apis-libraryagent_v1.gemspec b/generated/google-apis-libraryagent_v1/google-apis-libraryagent_v1.gemspec index f805d9b22..567acfecf 100644 --- a/generated/google-apis-libraryagent_v1/google-apis-libraryagent_v1.gemspec +++ b/generated/google-apis-libraryagent_v1/google-apis-libraryagent_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LibraryagentV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Library Agent API V1" + gem.summary = "Simple REST client for Library Agent API V1" gem.description = - "This is the legacy REST client for Library Agent API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Library Agent API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-libraryagent_v1/lib/google/apis/libraryagent_v1/gem_version.rb b/generated/google-apis-libraryagent_v1/lib/google/apis/libraryagent_v1/gem_version.rb index 8f02f704b..f9ecaf59c 100644 --- a/generated/google-apis-libraryagent_v1/lib/google/apis/libraryagent_v1/gem_version.rb +++ b/generated/google-apis-libraryagent_v1/lib/google/apis/libraryagent_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-licensing_v1/CHANGELOG.md b/generated/google-apis-licensing_v1/CHANGELOG.md index 9a4074338..988022d17 100644 --- a/generated/google-apis-licensing_v1/CHANGELOG.md +++ b/generated/google-apis-licensing_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-licensing_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201116 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-licensing_v1/OVERVIEW.md b/generated/google-apis-licensing_v1/OVERVIEW.md index 1f3a6f6ab..373c335d3 100644 --- a/generated/google-apis-licensing_v1/OVERVIEW.md +++ b/generated/google-apis-licensing_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Enterprise License Manager API +# Simple REST client for version V1 of the Enterprise License Manager API This is a simple client library for version V1 of the Enterprise License Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Enterprise License Manager * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Licensing service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Licensing service in particular.) For reference information on specific calls in the Enterprise License Manager API, see the {Google::Apis::LicensingV1::LicensingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-licensing_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-licensing_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/admin-sdk/licensing/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-licensing_v1/google-apis-licensing_v1.gemspec b/generated/google-apis-licensing_v1/google-apis-licensing_v1.gemspec index ebea9162b..7af7de66e 100644 --- a/generated/google-apis-licensing_v1/google-apis-licensing_v1.gemspec +++ b/generated/google-apis-licensing_v1/google-apis-licensing_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LicensingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Enterprise License Manager API V1" + gem.summary = "Simple REST client for Enterprise License Manager API V1" gem.description = - "This is the legacy REST client for Enterprise License Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Enterprise License Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-licensing_v1/lib/google/apis/licensing_v1/gem_version.rb b/generated/google-apis-licensing_v1/lib/google/apis/licensing_v1/gem_version.rb index 44935b214..2b1edbbc0 100644 --- a/generated/google-apis-licensing_v1/lib/google/apis/licensing_v1/gem_version.rb +++ b/generated/google-apis-licensing_v1/lib/google/apis/licensing_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201116" diff --git a/generated/google-apis-lifesciences_v2beta/CHANGELOG.md b/generated/google-apis-lifesciences_v2beta/CHANGELOG.md index 9446e973e..d6b1998a4 100644 --- a/generated/google-apis-lifesciences_v2beta/CHANGELOG.md +++ b/generated/google-apis-lifesciences_v2beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-lifesciences_v2beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-lifesciences_v2beta/OVERVIEW.md b/generated/google-apis-lifesciences_v2beta/OVERVIEW.md index 446014cc9..8884bbf05 100644 --- a/generated/google-apis-lifesciences_v2beta/OVERVIEW.md +++ b/generated/google-apis-lifesciences_v2beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta of the Cloud Life Sciences API +# Simple REST client for version V2beta of the Cloud Life Sciences API This is a simple client library for version V2beta of the Cloud Life Sciences API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta of the Cloud Life Sciences AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Lifesciences service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Lifesciences service in particular.) For reference information on specific calls in the Cloud Life Sciences API, see the {Google::Apis::LifesciencesV2beta::CloudLifeSciencesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-lifesciences_v2beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-lifesciences_v2beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/life-sciences) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-lifesciences_v2beta/google-apis-lifesciences_v2beta.gemspec b/generated/google-apis-lifesciences_v2beta/google-apis-lifesciences_v2beta.gemspec index a4e6189d4..3efcbe8cd 100644 --- a/generated/google-apis-lifesciences_v2beta/google-apis-lifesciences_v2beta.gemspec +++ b/generated/google-apis-lifesciences_v2beta/google-apis-lifesciences_v2beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LifesciencesV2beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Life Sciences API V2beta" + gem.summary = "Simple REST client for Cloud Life Sciences API V2beta" gem.description = - "This is the legacy REST client for Cloud Life Sciences API V2beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Life Sciences API V2beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-lifesciences_v2beta/lib/google/apis/lifesciences_v2beta/gem_version.rb b/generated/google-apis-lifesciences_v2beta/lib/google/apis/lifesciences_v2beta/gem_version.rb index 0edf7cc44..e321a82b1 100644 --- a/generated/google-apis-lifesciences_v2beta/lib/google/apis/lifesciences_v2beta/gem_version.rb +++ b/generated/google-apis-lifesciences_v2beta/lib/google/apis/lifesciences_v2beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201213" diff --git a/generated/google-apis-localservices_v1/CHANGELOG.md b/generated/google-apis-localservices_v1/CHANGELOG.md index 9374d58b1..17709cfbf 100644 --- a/generated/google-apis-localservices_v1/CHANGELOG.md +++ b/generated/google-apis-localservices_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-localservices_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-localservices_v1/OVERVIEW.md b/generated/google-apis-localservices_v1/OVERVIEW.md index 750ae00a1..9882f421e 100644 --- a/generated/google-apis-localservices_v1/OVERVIEW.md +++ b/generated/google-apis-localservices_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Local Services API +# Simple REST client for version V1 of the Local Services API This is a simple client library for version V1 of the Local Services API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Local Services API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Localservices service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Localservices service in particular.) For reference information on specific calls in the Local Services API, see the {Google::Apis::LocalservicesV1::LocalservicesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-localservices_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-localservices_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://ads.google.com/local-services-ads/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-localservices_v1/google-apis-localservices_v1.gemspec b/generated/google-apis-localservices_v1/google-apis-localservices_v1.gemspec index 21ee663fb..9ecb89955 100644 --- a/generated/google-apis-localservices_v1/google-apis-localservices_v1.gemspec +++ b/generated/google-apis-localservices_v1/google-apis-localservices_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LocalservicesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Local Services API V1" + gem.summary = "Simple REST client for Local Services API V1" gem.description = - "This is the legacy REST client for Local Services API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Local Services API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-localservices_v1/lib/google/apis/localservices_v1/gem_version.rb b/generated/google-apis-localservices_v1/lib/google/apis/localservices_v1/gem_version.rb index 022976804..fd55d21e9 100644 --- a/generated/google-apis-localservices_v1/lib/google/apis/localservices_v1/gem_version.rb +++ b/generated/google-apis-localservices_v1/lib/google/apis/localservices_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201213" diff --git a/generated/google-apis-logging_v2/CHANGELOG.md b/generated/google-apis-logging_v2/CHANGELOG.md index 803bae880..64a50e4a7 100644 --- a/generated/google-apis-logging_v2/CHANGELOG.md +++ b/generated/google-apis-logging_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-logging_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201114 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-logging_v2/OVERVIEW.md b/generated/google-apis-logging_v2/OVERVIEW.md index 884ca04f4..ac85458ae 100644 --- a/generated/google-apis-logging_v2/OVERVIEW.md +++ b/generated/google-apis-logging_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Cloud Logging API +# Simple REST client for version V2 of the Cloud Logging API This is a simple client library for version V2 of the Cloud Logging API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Cloud Logging API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Logging service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Logging service in particular.) For reference information on specific calls in the Cloud Logging API, see the {Google::Apis::LoggingV2::LoggingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-logging_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-logging_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/logging/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-logging_v2/google-apis-logging_v2.gemspec b/generated/google-apis-logging_v2/google-apis-logging_v2.gemspec index 3406007af..35058103b 100644 --- a/generated/google-apis-logging_v2/google-apis-logging_v2.gemspec +++ b/generated/google-apis-logging_v2/google-apis-logging_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::LoggingV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Logging API V2" + gem.summary = "Simple REST client for Cloud Logging API V2" gem.description = - "This is the legacy REST client for Cloud Logging API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Logging API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb b/generated/google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb index a31c3516a..a1ef28b01 100644 --- a/generated/google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb +++ b/generated/google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201114" diff --git a/generated/google-apis-managedidentities_v1/CHANGELOG.md b/generated/google-apis-managedidentities_v1/CHANGELOG.md index 723455a2a..3f055230d 100644 --- a/generated/google-apis-managedidentities_v1/CHANGELOG.md +++ b/generated/google-apis-managedidentities_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-managedidentities_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-managedidentities_v1/OVERVIEW.md b/generated/google-apis-managedidentities_v1/OVERVIEW.md index 797e2c84a..87d2dc560 100644 --- a/generated/google-apis-managedidentities_v1/OVERVIEW.md +++ b/generated/google-apis-managedidentities_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Managed Service for Microsoft Active Directory API +# Simple REST client for version V1 of the Managed Service for Microsoft Active Directory API This is a simple client library for version V1 of the Managed Service for Microsoft Active Directory API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Managed Service for Micros * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Managedidentities service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Managedidentities service in particular.) For reference information on specific calls in the Managed Service for Microsoft Active Directory API, see the {Google::Apis::ManagedidentitiesV1::ManagedServiceforMicrosoftActiveDirectoryConsumerAPIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-managedidentities_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-managedidentities_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/managed-microsoft-ad/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-managedidentities_v1/google-apis-managedidentities_v1.gemspec b/generated/google-apis-managedidentities_v1/google-apis-managedidentities_v1.gemspec index 64f96a52f..78c0da671 100644 --- a/generated/google-apis-managedidentities_v1/google-apis-managedidentities_v1.gemspec +++ b/generated/google-apis-managedidentities_v1/google-apis-managedidentities_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ManagedidentitiesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Managed Service for Microsoft Active Directory API V1" + gem.summary = "Simple REST client for Managed Service for Microsoft Active Directory API V1" gem.description = - "This is the legacy REST client for Managed Service for Microsoft Active Directory API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Managed Service for Microsoft Active Directory API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-managedidentities_v1/lib/google/apis/managedidentities_v1/gem_version.rb b/generated/google-apis-managedidentities_v1/lib/google/apis/managedidentities_v1/gem_version.rb index 71ddbc8c2..d79312e18 100644 --- a/generated/google-apis-managedidentities_v1/lib/google/apis/managedidentities_v1/gem_version.rb +++ b/generated/google-apis-managedidentities_v1/lib/google/apis/managedidentities_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-managedidentities_v1alpha1/CHANGELOG.md b/generated/google-apis-managedidentities_v1alpha1/CHANGELOG.md index f2cdf0111..38a46e290 100644 --- a/generated/google-apis-managedidentities_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-managedidentities_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-managedidentities_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-managedidentities_v1alpha1/OVERVIEW.md b/generated/google-apis-managedidentities_v1alpha1/OVERVIEW.md index 91781f741..d32556ca4 100644 --- a/generated/google-apis-managedidentities_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-managedidentities_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Managed Service for Microsoft Active Directory API +# Simple REST client for version V1alpha1 of the Managed Service for Microsoft Active Directory API This is a simple client library for version V1alpha1 of the Managed Service for Microsoft Active Directory API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Managed Service for * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Managedidentities service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Managedidentities service in particular.) For reference information on specific calls in the Managed Service for Microsoft Active Directory API, see the {Google::Apis::ManagedidentitiesV1alpha1::ManagedServiceforMicrosoftActiveDirectoryConsumerAPIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-managedidentities_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-managedidentities_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/managed-microsoft-ad/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-managedidentities_v1alpha1/google-apis-managedidentities_v1alpha1.gemspec b/generated/google-apis-managedidentities_v1alpha1/google-apis-managedidentities_v1alpha1.gemspec index 2fc26bb1f..ad18d0111 100644 --- a/generated/google-apis-managedidentities_v1alpha1/google-apis-managedidentities_v1alpha1.gemspec +++ b/generated/google-apis-managedidentities_v1alpha1/google-apis-managedidentities_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ManagedidentitiesV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Managed Service for Microsoft Active Directory API V1alpha1" + gem.summary = "Simple REST client for Managed Service for Microsoft Active Directory API V1alpha1" gem.description = - "This is the legacy REST client for Managed Service for Microsoft Active Directory API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Managed Service for Microsoft Active Directory API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-managedidentities_v1alpha1/lib/google/apis/managedidentities_v1alpha1/gem_version.rb b/generated/google-apis-managedidentities_v1alpha1/lib/google/apis/managedidentities_v1alpha1/gem_version.rb index 2e52b4852..ad92977ec 100644 --- a/generated/google-apis-managedidentities_v1alpha1/lib/google/apis/managedidentities_v1alpha1/gem_version.rb +++ b/generated/google-apis-managedidentities_v1alpha1/lib/google/apis/managedidentities_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-managedidentities_v1beta1/CHANGELOG.md b/generated/google-apis-managedidentities_v1beta1/CHANGELOG.md index 08742b007..57accf3f0 100644 --- a/generated/google-apis-managedidentities_v1beta1/CHANGELOG.md +++ b/generated/google-apis-managedidentities_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-managedidentities_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-managedidentities_v1beta1/OVERVIEW.md b/generated/google-apis-managedidentities_v1beta1/OVERVIEW.md index 7e669697e..b700a3866 100644 --- a/generated/google-apis-managedidentities_v1beta1/OVERVIEW.md +++ b/generated/google-apis-managedidentities_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Managed Service for Microsoft Active Directory API +# Simple REST client for version V1beta1 of the Managed Service for Microsoft Active Directory API This is a simple client library for version V1beta1 of the Managed Service for Microsoft Active Directory API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Managed Service for M * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Managedidentities service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Managedidentities service in particular.) For reference information on specific calls in the Managed Service for Microsoft Active Directory API, see the {Google::Apis::ManagedidentitiesV1beta1::ManagedServiceforMicrosoftActiveDirectoryConsumerAPIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-managedidentities_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-managedidentities_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/managed-microsoft-ad/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-managedidentities_v1beta1/google-apis-managedidentities_v1beta1.gemspec b/generated/google-apis-managedidentities_v1beta1/google-apis-managedidentities_v1beta1.gemspec index ad020dbd9..4df343072 100644 --- a/generated/google-apis-managedidentities_v1beta1/google-apis-managedidentities_v1beta1.gemspec +++ b/generated/google-apis-managedidentities_v1beta1/google-apis-managedidentities_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ManagedidentitiesV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Managed Service for Microsoft Active Directory API V1beta1" + gem.summary = "Simple REST client for Managed Service for Microsoft Active Directory API V1beta1" gem.description = - "This is the legacy REST client for Managed Service for Microsoft Active Directory API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Managed Service for Microsoft Active Directory API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-managedidentities_v1beta1/lib/google/apis/managedidentities_v1beta1/gem_version.rb b/generated/google-apis-managedidentities_v1beta1/lib/google/apis/managedidentities_v1beta1/gem_version.rb index be8e86cfe..f71fc8832 100644 --- a/generated/google-apis-managedidentities_v1beta1/lib/google/apis/managedidentities_v1beta1/gem_version.rb +++ b/generated/google-apis-managedidentities_v1beta1/lib/google/apis/managedidentities_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-manufacturers_v1/CHANGELOG.md b/generated/google-apis-manufacturers_v1/CHANGELOG.md index dcd2a6bcd..0bfa4af7c 100644 --- a/generated/google-apis-manufacturers_v1/CHANGELOG.md +++ b/generated/google-apis-manufacturers_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-manufacturers_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-manufacturers_v1/OVERVIEW.md b/generated/google-apis-manufacturers_v1/OVERVIEW.md index 77636f977..532dde772 100644 --- a/generated/google-apis-manufacturers_v1/OVERVIEW.md +++ b/generated/google-apis-manufacturers_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Manufacturer Center API +# Simple REST client for version V1 of the Manufacturer Center API This is a simple client library for version V1 of the Manufacturer Center API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Manufacturer Center API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Manufacturers service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Manufacturers service in particular.) For reference information on specific calls in the Manufacturer Center API, see the {Google::Apis::ManufacturersV1::ManufacturerCenterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-manufacturers_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-manufacturers_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/manufacturers/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-manufacturers_v1/google-apis-manufacturers_v1.gemspec b/generated/google-apis-manufacturers_v1/google-apis-manufacturers_v1.gemspec index c1dceb8a3..7ce3fbeb8 100644 --- a/generated/google-apis-manufacturers_v1/google-apis-manufacturers_v1.gemspec +++ b/generated/google-apis-manufacturers_v1/google-apis-manufacturers_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ManufacturersV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Manufacturer Center API V1" + gem.summary = "Simple REST client for Manufacturer Center API V1" gem.description = - "This is the legacy REST client for Manufacturer Center API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Manufacturer Center API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-manufacturers_v1/lib/google/apis/manufacturers_v1/gem_version.rb b/generated/google-apis-manufacturers_v1/lib/google/apis/manufacturers_v1/gem_version.rb index dcb030bd7..ef08b30d5 100644 --- a/generated/google-apis-manufacturers_v1/lib/google/apis/manufacturers_v1/gem_version.rb +++ b/generated/google-apis-manufacturers_v1/lib/google/apis/manufacturers_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-memcache_v1beta2/CHANGELOG.md b/generated/google-apis-memcache_v1beta2/CHANGELOG.md index 1538177c7..3cdd4366f 100644 --- a/generated/google-apis-memcache_v1beta2/CHANGELOG.md +++ b/generated/google-apis-memcache_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-memcache_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201109 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-memcache_v1beta2/OVERVIEW.md b/generated/google-apis-memcache_v1beta2/OVERVIEW.md index 73d5ad6a3..b3ad192ce 100644 --- a/generated/google-apis-memcache_v1beta2/OVERVIEW.md +++ b/generated/google-apis-memcache_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Memorystore for Memcached API +# Simple REST client for version V1beta2 of the Cloud Memorystore for Memcached API This is a simple client library for version V1beta2 of the Cloud Memorystore for Memcached API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Memorystore for * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Memcache service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Memcache service in particular.) For reference information on specific calls in the Cloud Memorystore for Memcached API, see the {Google::Apis::MemcacheV1beta2::CloudMemorystoreforMemcachedService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-memcache_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-memcache_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/memorystore/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-memcache_v1beta2/google-apis-memcache_v1beta2.gemspec b/generated/google-apis-memcache_v1beta2/google-apis-memcache_v1beta2.gemspec index b9fdff033..374e4bfde 100644 --- a/generated/google-apis-memcache_v1beta2/google-apis-memcache_v1beta2.gemspec +++ b/generated/google-apis-memcache_v1beta2/google-apis-memcache_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MemcacheV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Memorystore for Memcached API V1beta2" + gem.summary = "Simple REST client for Cloud Memorystore for Memcached API V1beta2" gem.description = - "This is the legacy REST client for Cloud Memorystore for Memcached API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Memorystore for Memcached API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-memcache_v1beta2/lib/google/apis/memcache_v1beta2/gem_version.rb b/generated/google-apis-memcache_v1beta2/lib/google/apis/memcache_v1beta2/gem_version.rb index fbe8e7753..74a73775c 100644 --- a/generated/google-apis-memcache_v1beta2/lib/google/apis/memcache_v1beta2/gem_version.rb +++ b/generated/google-apis-memcache_v1beta2/lib/google/apis/memcache_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201109" diff --git a/generated/google-apis-metastore_v1alpha/CHANGELOG.md b/generated/google-apis-metastore_v1alpha/CHANGELOG.md index 680709d1d..471cf01db 100644 --- a/generated/google-apis-metastore_v1alpha/CHANGELOG.md +++ b/generated/google-apis-metastore_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-metastore_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201212 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-metastore_v1alpha/OVERVIEW.md b/generated/google-apis-metastore_v1alpha/OVERVIEW.md index 85bd733b4..74474e4b7 100644 --- a/generated/google-apis-metastore_v1alpha/OVERVIEW.md +++ b/generated/google-apis-metastore_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Dataproc Metastore API +# Simple REST client for version V1alpha of the Dataproc Metastore API This is a simple client library for version V1alpha of the Dataproc Metastore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Dataproc Metastore AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Metastore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Metastore service in particular.) For reference information on specific calls in the Dataproc Metastore API, see the {Google::Apis::MetastoreV1alpha::DataprocMetastoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-metastore_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-metastore_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dataproc-metastore/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-metastore_v1alpha/google-apis-metastore_v1alpha.gemspec b/generated/google-apis-metastore_v1alpha/google-apis-metastore_v1alpha.gemspec index af12c208a..6d97568d2 100644 --- a/generated/google-apis-metastore_v1alpha/google-apis-metastore_v1alpha.gemspec +++ b/generated/google-apis-metastore_v1alpha/google-apis-metastore_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MetastoreV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dataproc Metastore API V1alpha" + gem.summary = "Simple REST client for Dataproc Metastore API V1alpha" gem.description = - "This is the legacy REST client for Dataproc Metastore API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dataproc Metastore API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-metastore_v1alpha/lib/google/apis/metastore_v1alpha/gem_version.rb b/generated/google-apis-metastore_v1alpha/lib/google/apis/metastore_v1alpha/gem_version.rb index e9134d3b6..33ea975d8 100644 --- a/generated/google-apis-metastore_v1alpha/lib/google/apis/metastore_v1alpha/gem_version.rb +++ b/generated/google-apis-metastore_v1alpha/lib/google/apis/metastore_v1alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201212" diff --git a/generated/google-apis-metastore_v1beta/CHANGELOG.md b/generated/google-apis-metastore_v1beta/CHANGELOG.md index 0369882c9..256be4cd0 100644 --- a/generated/google-apis-metastore_v1beta/CHANGELOG.md +++ b/generated/google-apis-metastore_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-metastore_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201212 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-metastore_v1beta/OVERVIEW.md b/generated/google-apis-metastore_v1beta/OVERVIEW.md index 1b47df9aa..a5cac12f6 100644 --- a/generated/google-apis-metastore_v1beta/OVERVIEW.md +++ b/generated/google-apis-metastore_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Dataproc Metastore API +# Simple REST client for version V1beta of the Dataproc Metastore API This is a simple client library for version V1beta of the Dataproc Metastore API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Dataproc Metastore API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Metastore service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Metastore service in particular.) For reference information on specific calls in the Dataproc Metastore API, see the {Google::Apis::MetastoreV1beta::DataprocMetastoreService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-metastore_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-metastore_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/dataproc-metastore/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-metastore_v1beta/google-apis-metastore_v1beta.gemspec b/generated/google-apis-metastore_v1beta/google-apis-metastore_v1beta.gemspec index c4c31ef68..0aaab527d 100644 --- a/generated/google-apis-metastore_v1beta/google-apis-metastore_v1beta.gemspec +++ b/generated/google-apis-metastore_v1beta/google-apis-metastore_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MetastoreV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Dataproc Metastore API V1beta" + gem.summary = "Simple REST client for Dataproc Metastore API V1beta" gem.description = - "This is the legacy REST client for Dataproc Metastore API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Dataproc Metastore API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-metastore_v1beta/lib/google/apis/metastore_v1beta/gem_version.rb b/generated/google-apis-metastore_v1beta/lib/google/apis/metastore_v1beta/gem_version.rb index f68be25af..42cb123c8 100644 --- a/generated/google-apis-metastore_v1beta/lib/google/apis/metastore_v1beta/gem_version.rb +++ b/generated/google-apis-metastore_v1beta/lib/google/apis/metastore_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201212" diff --git a/generated/google-apis-ml_v1/CHANGELOG.md b/generated/google-apis-ml_v1/CHANGELOG.md index e4511f317..4d76b2aa7 100644 --- a/generated/google-apis-ml_v1/CHANGELOG.md +++ b/generated/google-apis-ml_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-ml_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-ml_v1/OVERVIEW.md b/generated/google-apis-ml_v1/OVERVIEW.md index 9eac908d0..ca5e1176d 100644 --- a/generated/google-apis-ml_v1/OVERVIEW.md +++ b/generated/google-apis-ml_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the AI Platform Training & Prediction API +# Simple REST client for version V1 of the AI Platform Training & Prediction API This is a simple client library for version V1 of the AI Platform Training & Prediction API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the AI Platform Training & Pre * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Ml service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Ml service in particular.) For reference information on specific calls in the AI Platform Training & Prediction API, see the {Google::Apis::MlV1::CloudMachineLearningEngineService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-ml_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-ml_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/ml/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-ml_v1/google-apis-ml_v1.gemspec b/generated/google-apis-ml_v1/google-apis-ml_v1.gemspec index a3dca77bc..01e324b0f 100644 --- a/generated/google-apis-ml_v1/google-apis-ml_v1.gemspec +++ b/generated/google-apis-ml_v1/google-apis-ml_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MlV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for AI Platform Training & Prediction API V1" + gem.summary = "Simple REST client for AI Platform Training & Prediction API V1" gem.description = - "This is the legacy REST client for AI Platform Training & Prediction API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for AI Platform Training & Prediction API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-ml_v1/lib/google/apis/ml_v1/gem_version.rb b/generated/google-apis-ml_v1/lib/google/apis/ml_v1/gem_version.rb index 979e11c66..43507b0c4 100644 --- a/generated/google-apis-ml_v1/lib/google/apis/ml_v1/gem_version.rb +++ b/generated/google-apis-ml_v1/lib/google/apis/ml_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-monitoring_v1/CHANGELOG.md b/generated/google-apis-monitoring_v1/CHANGELOG.md index e4e1a790a..ebf2a9a73 100644 --- a/generated/google-apis-monitoring_v1/CHANGELOG.md +++ b/generated/google-apis-monitoring_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-monitoring_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200915 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-monitoring_v1/OVERVIEW.md b/generated/google-apis-monitoring_v1/OVERVIEW.md index 995e1844d..8760c0556 100644 --- a/generated/google-apis-monitoring_v1/OVERVIEW.md +++ b/generated/google-apis-monitoring_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Monitoring API +# Simple REST client for version V1 of the Cloud Monitoring API This is a simple client library for version V1 of the Cloud Monitoring API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Monitoring API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Monitoring service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Monitoring service in particular.) For reference information on specific calls in the Cloud Monitoring API, see the {Google::Apis::MonitoringV1::MonitoringService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-monitoring_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-monitoring_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/monitoring/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-monitoring_v1/google-apis-monitoring_v1.gemspec b/generated/google-apis-monitoring_v1/google-apis-monitoring_v1.gemspec index 5b56716f0..34d67c678 100644 --- a/generated/google-apis-monitoring_v1/google-apis-monitoring_v1.gemspec +++ b/generated/google-apis-monitoring_v1/google-apis-monitoring_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MonitoringV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Monitoring API V1" + gem.summary = "Simple REST client for Cloud Monitoring API V1" gem.description = - "This is the legacy REST client for Cloud Monitoring API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Monitoring API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-monitoring_v1/lib/google/apis/monitoring_v1/gem_version.rb b/generated/google-apis-monitoring_v1/lib/google/apis/monitoring_v1/gem_version.rb index ddca276e1..b907e1a4d 100644 --- a/generated/google-apis-monitoring_v1/lib/google/apis/monitoring_v1/gem_version.rb +++ b/generated/google-apis-monitoring_v1/lib/google/apis/monitoring_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200915" diff --git a/generated/google-apis-monitoring_v3/CHANGELOG.md b/generated/google-apis-monitoring_v3/CHANGELOG.md index 2213299c2..4e62d4686 100644 --- a/generated/google-apis-monitoring_v3/CHANGELOG.md +++ b/generated/google-apis-monitoring_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-monitoring_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-monitoring_v3/OVERVIEW.md b/generated/google-apis-monitoring_v3/OVERVIEW.md index 1149a0ab9..27741ddea 100644 --- a/generated/google-apis-monitoring_v3/OVERVIEW.md +++ b/generated/google-apis-monitoring_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Cloud Monitoring API +# Simple REST client for version V3 of the Cloud Monitoring API This is a simple client library for version V3 of the Cloud Monitoring API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Cloud Monitoring API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Monitoring service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Monitoring service in particular.) For reference information on specific calls in the Cloud Monitoring API, see the {Google::Apis::MonitoringV3::MonitoringService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-monitoring_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-monitoring_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/monitoring/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-monitoring_v3/google-apis-monitoring_v3.gemspec b/generated/google-apis-monitoring_v3/google-apis-monitoring_v3.gemspec index f4a63fe82..a5ea48397 100644 --- a/generated/google-apis-monitoring_v3/google-apis-monitoring_v3.gemspec +++ b/generated/google-apis-monitoring_v3/google-apis-monitoring_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::MonitoringV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Monitoring API V3" + gem.summary = "Simple REST client for Cloud Monitoring API V3" gem.description = - "This is the legacy REST client for Cloud Monitoring API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Monitoring API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-monitoring_v3/lib/google/apis/monitoring_v3/gem_version.rb b/generated/google-apis-monitoring_v3/lib/google/apis/monitoring_v3/gem_version.rb index 0a6531ca0..d54f6ede8 100644 --- a/generated/google-apis-monitoring_v3/lib/google/apis/monitoring_v3/gem_version.rb +++ b/generated/google-apis-monitoring_v3/lib/google/apis/monitoring_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201213" diff --git a/generated/google-apis-networkmanagement_v1/CHANGELOG.md b/generated/google-apis-networkmanagement_v1/CHANGELOG.md index 3042da15d..6d6cc95b8 100644 --- a/generated/google-apis-networkmanagement_v1/CHANGELOG.md +++ b/generated/google-apis-networkmanagement_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-networkmanagement_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201029 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-networkmanagement_v1/OVERVIEW.md b/generated/google-apis-networkmanagement_v1/OVERVIEW.md index a647ea4bf..af07655f4 100644 --- a/generated/google-apis-networkmanagement_v1/OVERVIEW.md +++ b/generated/google-apis-networkmanagement_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Network Management API +# Simple REST client for version V1 of the Network Management API This is a simple client library for version V1 of the Network Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Network Management API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Networkmanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Networkmanagement service in particular.) For reference information on specific calls in the Network Management API, see the {Google::Apis::NetworkmanagementV1::NetworkManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-networkmanagement_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-networkmanagement_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-networkmanagement_v1/google-apis-networkmanagement_v1.gemspec b/generated/google-apis-networkmanagement_v1/google-apis-networkmanagement_v1.gemspec index 3d9caae4a..17f85eb22 100644 --- a/generated/google-apis-networkmanagement_v1/google-apis-networkmanagement_v1.gemspec +++ b/generated/google-apis-networkmanagement_v1/google-apis-networkmanagement_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::NetworkmanagementV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Network Management API V1" + gem.summary = "Simple REST client for Network Management API V1" gem.description = - "This is the legacy REST client for Network Management API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Network Management API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-networkmanagement_v1/lib/google/apis/networkmanagement_v1/gem_version.rb b/generated/google-apis-networkmanagement_v1/lib/google/apis/networkmanagement_v1/gem_version.rb index 312e7dddc..fc5af13f9 100644 --- a/generated/google-apis-networkmanagement_v1/lib/google/apis/networkmanagement_v1/gem_version.rb +++ b/generated/google-apis-networkmanagement_v1/lib/google/apis/networkmanagement_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201029" diff --git a/generated/google-apis-networkmanagement_v1beta1/CHANGELOG.md b/generated/google-apis-networkmanagement_v1beta1/CHANGELOG.md index a8f738b47..29e1e5401 100644 --- a/generated/google-apis-networkmanagement_v1beta1/CHANGELOG.md +++ b/generated/google-apis-networkmanagement_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-networkmanagement_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201029 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-networkmanagement_v1beta1/OVERVIEW.md b/generated/google-apis-networkmanagement_v1beta1/OVERVIEW.md index bdbd13ec6..4c3abcd21 100644 --- a/generated/google-apis-networkmanagement_v1beta1/OVERVIEW.md +++ b/generated/google-apis-networkmanagement_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Network Management API +# Simple REST client for version V1beta1 of the Network Management API This is a simple client library for version V1beta1 of the Network Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Network Management AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Networkmanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Networkmanagement service in particular.) For reference information on specific calls in the Network Management API, see the {Google::Apis::NetworkmanagementV1beta1::NetworkManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-networkmanagement_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-networkmanagement_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-networkmanagement_v1beta1/google-apis-networkmanagement_v1beta1.gemspec b/generated/google-apis-networkmanagement_v1beta1/google-apis-networkmanagement_v1beta1.gemspec index 7ce622dd4..2ead99a97 100644 --- a/generated/google-apis-networkmanagement_v1beta1/google-apis-networkmanagement_v1beta1.gemspec +++ b/generated/google-apis-networkmanagement_v1beta1/google-apis-networkmanagement_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::NetworkmanagementV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Network Management API V1beta1" + gem.summary = "Simple REST client for Network Management API V1beta1" gem.description = - "This is the legacy REST client for Network Management API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Network Management API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-networkmanagement_v1beta1/lib/google/apis/networkmanagement_v1beta1/gem_version.rb b/generated/google-apis-networkmanagement_v1beta1/lib/google/apis/networkmanagement_v1beta1/gem_version.rb index 70561b1d5..def2e3e34 100644 --- a/generated/google-apis-networkmanagement_v1beta1/lib/google/apis/networkmanagement_v1beta1/gem_version.rb +++ b/generated/google-apis-networkmanagement_v1beta1/lib/google/apis/networkmanagement_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201029" diff --git a/generated/google-apis-notebooks_v1/CHANGELOG.md b/generated/google-apis-notebooks_v1/CHANGELOG.md index cf1edc98b..d049e6ee3 100644 --- a/generated/google-apis-notebooks_v1/CHANGELOG.md +++ b/generated/google-apis-notebooks_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-notebooks_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-notebooks_v1/OVERVIEW.md b/generated/google-apis-notebooks_v1/OVERVIEW.md index 036865d68..dccd98c3c 100644 --- a/generated/google-apis-notebooks_v1/OVERVIEW.md +++ b/generated/google-apis-notebooks_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Notebooks API +# Simple REST client for version V1 of the Notebooks API This is a simple client library for version V1 of the Notebooks API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Notebooks API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Notebooks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Notebooks service in particular.) For reference information on specific calls in the Notebooks API, see the {Google::Apis::NotebooksV1::AIPlatformNotebooksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-notebooks_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-notebooks_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/ai-platform/notebooks/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-notebooks_v1/google-apis-notebooks_v1.gemspec b/generated/google-apis-notebooks_v1/google-apis-notebooks_v1.gemspec index 6825afed0..7e0d82a85 100644 --- a/generated/google-apis-notebooks_v1/google-apis-notebooks_v1.gemspec +++ b/generated/google-apis-notebooks_v1/google-apis-notebooks_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::NotebooksV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Notebooks API V1" + gem.summary = "Simple REST client for Notebooks API V1" gem.description = - "This is the legacy REST client for Notebooks API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Notebooks API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-notebooks_v1/lib/google/apis/notebooks_v1/gem_version.rb b/generated/google-apis-notebooks_v1/lib/google/apis/notebooks_v1/gem_version.rb index a9832bb95..08ba1ebdb 100644 --- a/generated/google-apis-notebooks_v1/lib/google/apis/notebooks_v1/gem_version.rb +++ b/generated/google-apis-notebooks_v1/lib/google/apis/notebooks_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-oauth2_v2/CHANGELOG.md b/generated/google-apis-oauth2_v2/CHANGELOG.md index 57317068e..4adfbabea 100644 --- a/generated/google-apis-oauth2_v2/CHANGELOG.md +++ b/generated/google-apis-oauth2_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-oauth2_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200213 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-oauth2_v2/OVERVIEW.md b/generated/google-apis-oauth2_v2/OVERVIEW.md index de244bbcb..2f9a511f9 100644 --- a/generated/google-apis-oauth2_v2/OVERVIEW.md +++ b/generated/google-apis-oauth2_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Google OAuth2 API +# Simple REST client for version V2 of the Google OAuth2 API This is a simple client library for version V2 of the Google OAuth2 API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Google OAuth2 API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Oauth2 service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Oauth2 service in particular.) For reference information on specific calls in the Google OAuth2 API, see the {Google::Apis::Oauth2V2::Oauth2Service class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-oauth2_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-oauth2_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/identity/protocols/oauth2/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-oauth2_v2/google-apis-oauth2_v2.gemspec b/generated/google-apis-oauth2_v2/google-apis-oauth2_v2.gemspec index 7bda2a0a1..576273dd2 100644 --- a/generated/google-apis-oauth2_v2/google-apis-oauth2_v2.gemspec +++ b/generated/google-apis-oauth2_v2/google-apis-oauth2_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::Oauth2V2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google OAuth2 API V2" + gem.summary = "Simple REST client for Google OAuth2 API V2" gem.description = - "This is the legacy REST client for Google OAuth2 API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google OAuth2 API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-oauth2_v2/lib/google/apis/oauth2_v2/gem_version.rb b/generated/google-apis-oauth2_v2/lib/google/apis/oauth2_v2/gem_version.rb index 3c2868e70..67961b4ba 100644 --- a/generated/google-apis-oauth2_v2/lib/google/apis/oauth2_v2/gem_version.rb +++ b/generated/google-apis-oauth2_v2/lib/google/apis/oauth2_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200213" diff --git a/generated/google-apis-osconfig_v1/CHANGELOG.md b/generated/google-apis-osconfig_v1/CHANGELOG.md index 8ecb81d01..1b3118050 100644 --- a/generated/google-apis-osconfig_v1/CHANGELOG.md +++ b/generated/google-apis-osconfig_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-osconfig_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-osconfig_v1/OVERVIEW.md b/generated/google-apis-osconfig_v1/OVERVIEW.md index 642685dbc..11f51a206 100644 --- a/generated/google-apis-osconfig_v1/OVERVIEW.md +++ b/generated/google-apis-osconfig_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the OS Config API +# Simple REST client for version V1 of the OS Config API This is a simple client library for version V1 of the OS Config API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the OS Config API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Osconfig service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Osconfig service in particular.) For reference information on specific calls in the OS Config API, see the {Google::Apis::OsconfigV1::OSConfigService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-osconfig_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-osconfig_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/compute/docs/manage-os) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-osconfig_v1/google-apis-osconfig_v1.gemspec b/generated/google-apis-osconfig_v1/google-apis-osconfig_v1.gemspec index 357a2de96..c4b8d1d22 100644 --- a/generated/google-apis-osconfig_v1/google-apis-osconfig_v1.gemspec +++ b/generated/google-apis-osconfig_v1/google-apis-osconfig_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::OsconfigV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for OS Config API V1" + gem.summary = "Simple REST client for OS Config API V1" gem.description = - "This is the legacy REST client for OS Config API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for OS Config API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-osconfig_v1/lib/google/apis/osconfig_v1/gem_version.rb b/generated/google-apis-osconfig_v1/lib/google/apis/osconfig_v1/gem_version.rb index 170b2aa9a..3632b6003 100644 --- a/generated/google-apis-osconfig_v1/lib/google/apis/osconfig_v1/gem_version.rb +++ b/generated/google-apis-osconfig_v1/lib/google/apis/osconfig_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-osconfig_v1beta/CHANGELOG.md b/generated/google-apis-osconfig_v1beta/CHANGELOG.md index ce508dd10..21199bbed 100644 --- a/generated/google-apis-osconfig_v1beta/CHANGELOG.md +++ b/generated/google-apis-osconfig_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-osconfig_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-osconfig_v1beta/OVERVIEW.md b/generated/google-apis-osconfig_v1beta/OVERVIEW.md index 5dbbf2993..3c5d8018a 100644 --- a/generated/google-apis-osconfig_v1beta/OVERVIEW.md +++ b/generated/google-apis-osconfig_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the OS Config API +# Simple REST client for version V1beta of the OS Config API This is a simple client library for version V1beta of the OS Config API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the OS Config API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Osconfig service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Osconfig service in particular.) For reference information on specific calls in the OS Config API, see the {Google::Apis::OsconfigV1beta::OSConfigService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-osconfig_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-osconfig_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/compute/docs/manage-os) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-osconfig_v1beta/google-apis-osconfig_v1beta.gemspec b/generated/google-apis-osconfig_v1beta/google-apis-osconfig_v1beta.gemspec index 6fd422e10..151cb1310 100644 --- a/generated/google-apis-osconfig_v1beta/google-apis-osconfig_v1beta.gemspec +++ b/generated/google-apis-osconfig_v1beta/google-apis-osconfig_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::OsconfigV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for OS Config API V1beta" + gem.summary = "Simple REST client for OS Config API V1beta" gem.description = - "This is the legacy REST client for OS Config API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for OS Config API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-osconfig_v1beta/lib/google/apis/osconfig_v1beta/gem_version.rb b/generated/google-apis-osconfig_v1beta/lib/google/apis/osconfig_v1beta/gem_version.rb index b4f5f22ae..cb45a66ae 100644 --- a/generated/google-apis-osconfig_v1beta/lib/google/apis/osconfig_v1beta/gem_version.rb +++ b/generated/google-apis-osconfig_v1beta/lib/google/apis/osconfig_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-oslogin_v1/CHANGELOG.md b/generated/google-apis-oslogin_v1/CHANGELOG.md index 6a0611b33..0b3016787 100644 --- a/generated/google-apis-oslogin_v1/CHANGELOG.md +++ b/generated/google-apis-oslogin_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-oslogin_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200810 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-oslogin_v1/OVERVIEW.md b/generated/google-apis-oslogin_v1/OVERVIEW.md index dae742b6e..018d4ad88 100644 --- a/generated/google-apis-oslogin_v1/OVERVIEW.md +++ b/generated/google-apis-oslogin_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud OS Login API +# Simple REST client for version V1 of the Cloud OS Login API This is a simple client library for version V1 of the Cloud OS Login API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud OS Login API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Oslogin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Oslogin service in particular.) For reference information on specific calls in the Cloud OS Login API, see the {Google::Apis::OsloginV1::CloudOSLoginService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-oslogin_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-oslogin_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/compute/docs/oslogin/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-oslogin_v1/google-apis-oslogin_v1.gemspec b/generated/google-apis-oslogin_v1/google-apis-oslogin_v1.gemspec index a32d3a724..6af722190 100644 --- a/generated/google-apis-oslogin_v1/google-apis-oslogin_v1.gemspec +++ b/generated/google-apis-oslogin_v1/google-apis-oslogin_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::OsloginV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud OS Login API V1" + gem.summary = "Simple REST client for Cloud OS Login API V1" gem.description = - "This is the legacy REST client for Cloud OS Login API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud OS Login API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-oslogin_v1/lib/google/apis/oslogin_v1/gem_version.rb b/generated/google-apis-oslogin_v1/lib/google/apis/oslogin_v1/gem_version.rb index 39aa72fea..674c4fec2 100644 --- a/generated/google-apis-oslogin_v1/lib/google/apis/oslogin_v1/gem_version.rb +++ b/generated/google-apis-oslogin_v1/lib/google/apis/oslogin_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200810" diff --git a/generated/google-apis-oslogin_v1alpha/CHANGELOG.md b/generated/google-apis-oslogin_v1alpha/CHANGELOG.md index 8fccfaed6..684ecd679 100644 --- a/generated/google-apis-oslogin_v1alpha/CHANGELOG.md +++ b/generated/google-apis-oslogin_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-oslogin_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200919 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-oslogin_v1alpha/OVERVIEW.md b/generated/google-apis-oslogin_v1alpha/OVERVIEW.md index dc44ee444..a64c68da1 100644 --- a/generated/google-apis-oslogin_v1alpha/OVERVIEW.md +++ b/generated/google-apis-oslogin_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Cloud OS Login API +# Simple REST client for version V1alpha of the Cloud OS Login API This is a simple client library for version V1alpha of the Cloud OS Login API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Cloud OS Login API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Oslogin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Oslogin service in particular.) For reference information on specific calls in the Cloud OS Login API, see the {Google::Apis::OsloginV1alpha::CloudOSLoginService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-oslogin_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-oslogin_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/compute/docs/oslogin/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-oslogin_v1alpha/google-apis-oslogin_v1alpha.gemspec b/generated/google-apis-oslogin_v1alpha/google-apis-oslogin_v1alpha.gemspec index 4f7caeccf..24524c3f2 100644 --- a/generated/google-apis-oslogin_v1alpha/google-apis-oslogin_v1alpha.gemspec +++ b/generated/google-apis-oslogin_v1alpha/google-apis-oslogin_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::OsloginV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud OS Login API V1alpha" + gem.summary = "Simple REST client for Cloud OS Login API V1alpha" gem.description = - "This is the legacy REST client for Cloud OS Login API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud OS Login API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-oslogin_v1alpha/lib/google/apis/oslogin_v1alpha/gem_version.rb b/generated/google-apis-oslogin_v1alpha/lib/google/apis/oslogin_v1alpha/gem_version.rb index 85beec875..141795651 100644 --- a/generated/google-apis-oslogin_v1alpha/lib/google/apis/oslogin_v1alpha/gem_version.rb +++ b/generated/google-apis-oslogin_v1alpha/lib/google/apis/oslogin_v1alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200919" diff --git a/generated/google-apis-oslogin_v1beta/CHANGELOG.md b/generated/google-apis-oslogin_v1beta/CHANGELOG.md index 0cb695e80..b1e632944 100644 --- a/generated/google-apis-oslogin_v1beta/CHANGELOG.md +++ b/generated/google-apis-oslogin_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-oslogin_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200810 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-oslogin_v1beta/OVERVIEW.md b/generated/google-apis-oslogin_v1beta/OVERVIEW.md index 77f361f93..b08b30a31 100644 --- a/generated/google-apis-oslogin_v1beta/OVERVIEW.md +++ b/generated/google-apis-oslogin_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Cloud OS Login API +# Simple REST client for version V1beta of the Cloud OS Login API This is a simple client library for version V1beta of the Cloud OS Login API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Cloud OS Login API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Oslogin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Oslogin service in particular.) For reference information on specific calls in the Cloud OS Login API, see the {Google::Apis::OsloginV1beta::CloudOSLoginService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-oslogin_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-oslogin_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/compute/docs/oslogin/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-oslogin_v1beta/google-apis-oslogin_v1beta.gemspec b/generated/google-apis-oslogin_v1beta/google-apis-oslogin_v1beta.gemspec index 1bb3ed1c9..7ed7c8ddb 100644 --- a/generated/google-apis-oslogin_v1beta/google-apis-oslogin_v1beta.gemspec +++ b/generated/google-apis-oslogin_v1beta/google-apis-oslogin_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::OsloginV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud OS Login API V1beta" + gem.summary = "Simple REST client for Cloud OS Login API V1beta" gem.description = - "This is the legacy REST client for Cloud OS Login API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud OS Login API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-oslogin_v1beta/lib/google/apis/oslogin_v1beta/gem_version.rb b/generated/google-apis-oslogin_v1beta/lib/google/apis/oslogin_v1beta/gem_version.rb index 984e7d3a5..93763a908 100644 --- a/generated/google-apis-oslogin_v1beta/lib/google/apis/oslogin_v1beta/gem_version.rb +++ b/generated/google-apis-oslogin_v1beta/lib/google/apis/oslogin_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200810" diff --git a/generated/google-apis-pagespeedonline_v5/CHANGELOG.md b/generated/google-apis-pagespeedonline_v5/CHANGELOG.md index 19e15bf53..70545bb6d 100644 --- a/generated/google-apis-pagespeedonline_v5/CHANGELOG.md +++ b/generated/google-apis-pagespeedonline_v5/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-pagespeedonline_v5 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201130 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-pagespeedonline_v5/OVERVIEW.md b/generated/google-apis-pagespeedonline_v5/OVERVIEW.md index fa4ec823d..8b42faf36 100644 --- a/generated/google-apis-pagespeedonline_v5/OVERVIEW.md +++ b/generated/google-apis-pagespeedonline_v5/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V5 of the PageSpeed Insights API +# Simple REST client for version V5 of the PageSpeed Insights API This is a simple client library for version V5 of the PageSpeed Insights API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V5 of the PageSpeed Insights API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Pagespeedonline service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Pagespeedonline service in particular.) For reference information on specific calls in the PageSpeed Insights API, see the {Google::Apis::PagespeedonlineV5::PagespeedInsightsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-pagespeedonline_v5`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-pagespeedonline_v5`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/speed/docs/insights/v5/about) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-pagespeedonline_v5/google-apis-pagespeedonline_v5.gemspec b/generated/google-apis-pagespeedonline_v5/google-apis-pagespeedonline_v5.gemspec index 9dfaf8112..16addafd5 100644 --- a/generated/google-apis-pagespeedonline_v5/google-apis-pagespeedonline_v5.gemspec +++ b/generated/google-apis-pagespeedonline_v5/google-apis-pagespeedonline_v5.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PagespeedonlineV5::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for PageSpeed Insights API V5" + gem.summary = "Simple REST client for PageSpeed Insights API V5" gem.description = - "This is the legacy REST client for PageSpeed Insights API V5." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for PageSpeed Insights API V5." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-pagespeedonline_v5/lib/google/apis/pagespeedonline_v5/gem_version.rb b/generated/google-apis-pagespeedonline_v5/lib/google/apis/pagespeedonline_v5/gem_version.rb index 395e00a69..e19226fe7 100644 --- a/generated/google-apis-pagespeedonline_v5/lib/google/apis/pagespeedonline_v5/gem_version.rb +++ b/generated/google-apis-pagespeedonline_v5/lib/google/apis/pagespeedonline_v5/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201130" diff --git a/generated/google-apis-people_v1/OVERVIEW.md b/generated/google-apis-people_v1/OVERVIEW.md index 0e987375f..41e576de7 100644 --- a/generated/google-apis-people_v1/OVERVIEW.md +++ b/generated/google-apis-people_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the People API +# Simple REST client for version V1 of the People API This is a simple client library for version V1 of the People API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the People API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the People service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the People service in particular.) For reference information on specific calls in the People API, see the {Google::Apis::PeopleV1::PeopleServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-people_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-people_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/people/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-people_v1/google-apis-people_v1.gemspec b/generated/google-apis-people_v1/google-apis-people_v1.gemspec index 3eedc8429..f5a857e00 100644 --- a/generated/google-apis-people_v1/google-apis-people_v1.gemspec +++ b/generated/google-apis-people_v1/google-apis-people_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PeopleV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for People API V1" + gem.summary = "Simple REST client for People API V1" gem.description = - "This is the legacy REST client for People API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for People API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-playablelocations_v3/CHANGELOG.md b/generated/google-apis-playablelocations_v3/CHANGELOG.md index e564d3585..84b6ae75c 100644 --- a/generated/google-apis-playablelocations_v3/CHANGELOG.md +++ b/generated/google-apis-playablelocations_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-playablelocations_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201013 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-playablelocations_v3/OVERVIEW.md b/generated/google-apis-playablelocations_v3/OVERVIEW.md index 4dbdf8ba7..3bb599076 100644 --- a/generated/google-apis-playablelocations_v3/OVERVIEW.md +++ b/generated/google-apis-playablelocations_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Playable Locations API +# Simple REST client for version V3 of the Playable Locations API This is a simple client library for version V3 of the Playable Locations API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Playable Locations API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Playablelocations service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Playablelocations service in particular.) For reference information on specific calls in the Playable Locations API, see the {Google::Apis::PlayablelocationsV3::PlayableLocationsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-playablelocations_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-playablelocations_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/maps/contact-sales/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-playablelocations_v3/google-apis-playablelocations_v3.gemspec b/generated/google-apis-playablelocations_v3/google-apis-playablelocations_v3.gemspec index f1ca1afeb..98b6df276 100644 --- a/generated/google-apis-playablelocations_v3/google-apis-playablelocations_v3.gemspec +++ b/generated/google-apis-playablelocations_v3/google-apis-playablelocations_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PlayablelocationsV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Playable Locations API V3" + gem.summary = "Simple REST client for Playable Locations API V3" gem.description = - "This is the legacy REST client for Playable Locations API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Playable Locations API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-playablelocations_v3/lib/google/apis/playablelocations_v3/gem_version.rb b/generated/google-apis-playablelocations_v3/lib/google/apis/playablelocations_v3/gem_version.rb index 24657b547..0c3178a86 100644 --- a/generated/google-apis-playablelocations_v3/lib/google/apis/playablelocations_v3/gem_version.rb +++ b/generated/google-apis-playablelocations_v3/lib/google/apis/playablelocations_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201013" diff --git a/generated/google-apis-playcustomapp_v1/CHANGELOG.md b/generated/google-apis-playcustomapp_v1/CHANGELOG.md index 5fe87aec2..a4aa63a7c 100644 --- a/generated/google-apis-playcustomapp_v1/CHANGELOG.md +++ b/generated/google-apis-playcustomapp_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-playcustomapp_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201020 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-playcustomapp_v1/OVERVIEW.md b/generated/google-apis-playcustomapp_v1/OVERVIEW.md index e20904fa1..5c292e724 100644 --- a/generated/google-apis-playcustomapp_v1/OVERVIEW.md +++ b/generated/google-apis-playcustomapp_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Play Custom App Publishing API +# Simple REST client for version V1 of the Google Play Custom App Publishing API This is a simple client library for version V1 of the Google Play Custom App Publishing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Play Custom App Pub * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Playcustomapp service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Playcustomapp service in particular.) For reference information on specific calls in the Google Play Custom App Publishing API, see the {Google::Apis::PlaycustomappV1::PlaycustomappService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-playcustomapp_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-playcustomapp_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/android/work/play/custom-app-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-playcustomapp_v1/google-apis-playcustomapp_v1.gemspec b/generated/google-apis-playcustomapp_v1/google-apis-playcustomapp_v1.gemspec index b0ee1bf8c..9ef3de5f7 100644 --- a/generated/google-apis-playcustomapp_v1/google-apis-playcustomapp_v1.gemspec +++ b/generated/google-apis-playcustomapp_v1/google-apis-playcustomapp_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PlaycustomappV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Play Custom App Publishing API V1" + gem.summary = "Simple REST client for Google Play Custom App Publishing API V1" gem.description = - "This is the legacy REST client for Google Play Custom App Publishing API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Play Custom App Publishing API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-playcustomapp_v1/lib/google/apis/playcustomapp_v1/gem_version.rb b/generated/google-apis-playcustomapp_v1/lib/google/apis/playcustomapp_v1/gem_version.rb index b89c29044..5ff853570 100644 --- a/generated/google-apis-playcustomapp_v1/lib/google/apis/playcustomapp_v1/gem_version.rb +++ b/generated/google-apis-playcustomapp_v1/lib/google/apis/playcustomapp_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201020" diff --git a/generated/google-apis-policytroubleshooter_v1/CHANGELOG.md b/generated/google-apis-policytroubleshooter_v1/CHANGELOG.md index d0c7f049c..e6fd010e5 100644 --- a/generated/google-apis-policytroubleshooter_v1/CHANGELOG.md +++ b/generated/google-apis-policytroubleshooter_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-policytroubleshooter_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201107 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-policytroubleshooter_v1/OVERVIEW.md b/generated/google-apis-policytroubleshooter_v1/OVERVIEW.md index 7bfd6dbb7..5af59c05c 100644 --- a/generated/google-apis-policytroubleshooter_v1/OVERVIEW.md +++ b/generated/google-apis-policytroubleshooter_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Policy Troubleshooter API +# Simple REST client for version V1 of the Policy Troubleshooter API This is a simple client library for version V1 of the Policy Troubleshooter API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Policy Troubleshooter API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Policytroubleshooter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Policytroubleshooter service in particular.) For reference information on specific calls in the Policy Troubleshooter API, see the {Google::Apis::PolicytroubleshooterV1::PolicyTroubleshooterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-policytroubleshooter_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-policytroubleshooter_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iam/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-policytroubleshooter_v1/google-apis-policytroubleshooter_v1.gemspec b/generated/google-apis-policytroubleshooter_v1/google-apis-policytroubleshooter_v1.gemspec index 1b0bad09c..a9b32d349 100644 --- a/generated/google-apis-policytroubleshooter_v1/google-apis-policytroubleshooter_v1.gemspec +++ b/generated/google-apis-policytroubleshooter_v1/google-apis-policytroubleshooter_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PolicytroubleshooterV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Policy Troubleshooter API V1" + gem.summary = "Simple REST client for Policy Troubleshooter API V1" gem.description = - "This is the legacy REST client for Policy Troubleshooter API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Policy Troubleshooter API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-policytroubleshooter_v1/lib/google/apis/policytroubleshooter_v1/gem_version.rb b/generated/google-apis-policytroubleshooter_v1/lib/google/apis/policytroubleshooter_v1/gem_version.rb index 75dc26454..f417e1bc9 100644 --- a/generated/google-apis-policytroubleshooter_v1/lib/google/apis/policytroubleshooter_v1/gem_version.rb +++ b/generated/google-apis-policytroubleshooter_v1/lib/google/apis/policytroubleshooter_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201107" diff --git a/generated/google-apis-policytroubleshooter_v1beta/CHANGELOG.md b/generated/google-apis-policytroubleshooter_v1beta/CHANGELOG.md index 14baded36..5b530ae44 100644 --- a/generated/google-apis-policytroubleshooter_v1beta/CHANGELOG.md +++ b/generated/google-apis-policytroubleshooter_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-policytroubleshooter_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201107 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-policytroubleshooter_v1beta/OVERVIEW.md b/generated/google-apis-policytroubleshooter_v1beta/OVERVIEW.md index 146392414..8286fa152 100644 --- a/generated/google-apis-policytroubleshooter_v1beta/OVERVIEW.md +++ b/generated/google-apis-policytroubleshooter_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Policy Troubleshooter API +# Simple REST client for version V1beta of the Policy Troubleshooter API This is a simple client library for version V1beta of the Policy Troubleshooter API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Policy Troubleshooter * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Policytroubleshooter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Policytroubleshooter service in particular.) For reference information on specific calls in the Policy Troubleshooter API, see the {Google::Apis::PolicytroubleshooterV1beta::PolicyTroubleshooterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-policytroubleshooter_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-policytroubleshooter_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/iam/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-policytroubleshooter_v1beta/google-apis-policytroubleshooter_v1beta.gemspec b/generated/google-apis-policytroubleshooter_v1beta/google-apis-policytroubleshooter_v1beta.gemspec index 57d489b5b..821bfc423 100644 --- a/generated/google-apis-policytroubleshooter_v1beta/google-apis-policytroubleshooter_v1beta.gemspec +++ b/generated/google-apis-policytroubleshooter_v1beta/google-apis-policytroubleshooter_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PolicytroubleshooterV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Policy Troubleshooter API V1beta" + gem.summary = "Simple REST client for Policy Troubleshooter API V1beta" gem.description = - "This is the legacy REST client for Policy Troubleshooter API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Policy Troubleshooter API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-policytroubleshooter_v1beta/lib/google/apis/policytroubleshooter_v1beta/gem_version.rb b/generated/google-apis-policytroubleshooter_v1beta/lib/google/apis/policytroubleshooter_v1beta/gem_version.rb index 6d76bb19c..c8b40957e 100644 --- a/generated/google-apis-policytroubleshooter_v1beta/lib/google/apis/policytroubleshooter_v1beta/gem_version.rb +++ b/generated/google-apis-policytroubleshooter_v1beta/lib/google/apis/policytroubleshooter_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201107" diff --git a/generated/google-apis-poly_v1/CHANGELOG.md b/generated/google-apis-poly_v1/CHANGELOG.md index 64bad0f24..bea51f517 100644 --- a/generated/google-apis-poly_v1/CHANGELOG.md +++ b/generated/google-apis-poly_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-poly_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201006 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-poly_v1/OVERVIEW.md b/generated/google-apis-poly_v1/OVERVIEW.md index 11ed0d7f1..dcb6d870d 100644 --- a/generated/google-apis-poly_v1/OVERVIEW.md +++ b/generated/google-apis-poly_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Poly API +# Simple REST client for version V1 of the Poly API This is a simple client library for version V1 of the Poly API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Poly API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Poly service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Poly service in particular.) For reference information on specific calls in the Poly API, see the {Google::Apis::PolyV1::PolyServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-poly_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-poly_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/poly/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-poly_v1/google-apis-poly_v1.gemspec b/generated/google-apis-poly_v1/google-apis-poly_v1.gemspec index bb634577b..ce58f31ff 100644 --- a/generated/google-apis-poly_v1/google-apis-poly_v1.gemspec +++ b/generated/google-apis-poly_v1/google-apis-poly_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PolyV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Poly API V1" + gem.summary = "Simple REST client for Poly API V1" gem.description = - "This is the legacy REST client for Poly API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Poly API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-poly_v1/lib/google/apis/poly_v1/gem_version.rb b/generated/google-apis-poly_v1/lib/google/apis/poly_v1/gem_version.rb index c371e73bd..8af782e13 100644 --- a/generated/google-apis-poly_v1/lib/google/apis/poly_v1/gem_version.rb +++ b/generated/google-apis-poly_v1/lib/google/apis/poly_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201006" diff --git a/generated/google-apis-privateca_v1beta1/CHANGELOG.md b/generated/google-apis-privateca_v1beta1/CHANGELOG.md index 4ae96111b..a830d370d 100644 --- a/generated/google-apis-privateca_v1beta1/CHANGELOG.md +++ b/generated/google-apis-privateca_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-privateca_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201203 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-privateca_v1beta1/OVERVIEW.md b/generated/google-apis-privateca_v1beta1/OVERVIEW.md index 54798e23a..8134c0c55 100644 --- a/generated/google-apis-privateca_v1beta1/OVERVIEW.md +++ b/generated/google-apis-privateca_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Certificate Authority API +# Simple REST client for version V1beta1 of the Certificate Authority API This is a simple client library for version V1beta1 of the Certificate Authority API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Certificate Authority * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Privateca service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Privateca service in particular.) For reference information on specific calls in the Certificate Authority API, see the {Google::Apis::PrivatecaV1beta1::CertificateAuthorityServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-privateca_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-privateca_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-privateca_v1beta1/google-apis-privateca_v1beta1.gemspec b/generated/google-apis-privateca_v1beta1/google-apis-privateca_v1beta1.gemspec index 1abc1ab63..d42adcd66 100644 --- a/generated/google-apis-privateca_v1beta1/google-apis-privateca_v1beta1.gemspec +++ b/generated/google-apis-privateca_v1beta1/google-apis-privateca_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PrivatecaV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Certificate Authority API V1beta1" + gem.summary = "Simple REST client for Certificate Authority API V1beta1" gem.description = - "This is the legacy REST client for Certificate Authority API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Certificate Authority API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-privateca_v1beta1/lib/google/apis/privateca_v1beta1/gem_version.rb b/generated/google-apis-privateca_v1beta1/lib/google/apis/privateca_v1beta1/gem_version.rb index ee7f74242..0bc3f46b0 100644 --- a/generated/google-apis-privateca_v1beta1/lib/google/apis/privateca_v1beta1/gem_version.rb +++ b/generated/google-apis-privateca_v1beta1/lib/google/apis/privateca_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201203" diff --git a/generated/google-apis-prod_tt_sasportal_v1alpha1/CHANGELOG.md b/generated/google-apis-prod_tt_sasportal_v1alpha1/CHANGELOG.md index a94c28174..d7fc5357b 100644 --- a/generated/google-apis-prod_tt_sasportal_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-prod_tt_sasportal_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-prod_tt_sasportal_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-prod_tt_sasportal_v1alpha1/OVERVIEW.md b/generated/google-apis-prod_tt_sasportal_v1alpha1/OVERVIEW.md index cc5e9f48b..875bf0baf 100644 --- a/generated/google-apis-prod_tt_sasportal_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-prod_tt_sasportal_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the SAS Portal API (Testing) +# Simple REST client for version V1alpha1 of the SAS Portal API (Testing) This is a simple client library for version V1alpha1 of the SAS Portal API (Testing). It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the SAS Portal API (Test * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the ProdTtSasportal service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the ProdTtSasportal service in particular.) For reference information on specific calls in the SAS Portal API (Testing), see the {Google::Apis::ProdTtSasportalV1alpha1::SASPortalTestingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-prod_tt_sasportal_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-prod_tt_sasportal_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/spectrum-access-system/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-prod_tt_sasportal_v1alpha1/google-apis-prod_tt_sasportal_v1alpha1.gemspec b/generated/google-apis-prod_tt_sasportal_v1alpha1/google-apis-prod_tt_sasportal_v1alpha1.gemspec index 744791c77..103e866c7 100644 --- a/generated/google-apis-prod_tt_sasportal_v1alpha1/google-apis-prod_tt_sasportal_v1alpha1.gemspec +++ b/generated/google-apis-prod_tt_sasportal_v1alpha1/google-apis-prod_tt_sasportal_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ProdTtSasportalV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for SAS Portal API (Testing) V1alpha1" + gem.summary = "Simple REST client for SAS Portal API (Testing) V1alpha1" gem.description = - "This is the legacy REST client for SAS Portal API (Testing) V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for SAS Portal API (Testing) V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-prod_tt_sasportal_v1alpha1/lib/google/apis/prod_tt_sasportal_v1alpha1/gem_version.rb b/generated/google-apis-prod_tt_sasportal_v1alpha1/lib/google/apis/prod_tt_sasportal_v1alpha1/gem_version.rb index 11f79a7ae..22e51666b 100644 --- a/generated/google-apis-prod_tt_sasportal_v1alpha1/lib/google/apis/prod_tt_sasportal_v1alpha1/gem_version.rb +++ b/generated/google-apis-prod_tt_sasportal_v1alpha1/lib/google/apis/prod_tt_sasportal_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-pubsub_v1/CHANGELOG.md b/generated/google-apis-pubsub_v1/CHANGELOG.md index ff903288c..f52143921 100644 --- a/generated/google-apis-pubsub_v1/CHANGELOG.md +++ b/generated/google-apis-pubsub_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-pubsub_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-pubsub_v1/OVERVIEW.md b/generated/google-apis-pubsub_v1/OVERVIEW.md index ac6db7d48..9e9cb7c84 100644 --- a/generated/google-apis-pubsub_v1/OVERVIEW.md +++ b/generated/google-apis-pubsub_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Pub/Sub API +# Simple REST client for version V1 of the Cloud Pub/Sub API This is a simple client library for version V1 of the Cloud Pub/Sub API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Pub/Sub API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Pubsub service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Pubsub service in particular.) For reference information on specific calls in the Cloud Pub/Sub API, see the {Google::Apis::PubsubV1::PubsubService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-pubsub_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-pubsub_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/pubsub/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-pubsub_v1/google-apis-pubsub_v1.gemspec b/generated/google-apis-pubsub_v1/google-apis-pubsub_v1.gemspec index 78a15e80b..d333bf781 100644 --- a/generated/google-apis-pubsub_v1/google-apis-pubsub_v1.gemspec +++ b/generated/google-apis-pubsub_v1/google-apis-pubsub_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PubsubV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Pub/Sub API V1" + gem.summary = "Simple REST client for Cloud Pub/Sub API V1" gem.description = - "This is the legacy REST client for Cloud Pub/Sub API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Pub/Sub API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-pubsub_v1/lib/google/apis/pubsub_v1/gem_version.rb b/generated/google-apis-pubsub_v1/lib/google/apis/pubsub_v1/gem_version.rb index 3dc6acca7..072244c81 100644 --- a/generated/google-apis-pubsub_v1/lib/google/apis/pubsub_v1/gem_version.rb +++ b/generated/google-apis-pubsub_v1/lib/google/apis/pubsub_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-pubsub_v1beta1a/CHANGELOG.md b/generated/google-apis-pubsub_v1beta1a/CHANGELOG.md index 26940b50e..cc013bcf8 100644 --- a/generated/google-apis-pubsub_v1beta1a/CHANGELOG.md +++ b/generated/google-apis-pubsub_v1beta1a/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-pubsub_v1beta1a -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200807 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-pubsub_v1beta1a/OVERVIEW.md b/generated/google-apis-pubsub_v1beta1a/OVERVIEW.md index 79156759e..f714154f2 100644 --- a/generated/google-apis-pubsub_v1beta1a/OVERVIEW.md +++ b/generated/google-apis-pubsub_v1beta1a/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1a of the Cloud Pub/Sub API +# Simple REST client for version V1beta1a of the Cloud Pub/Sub API This is a simple client library for version V1beta1a of the Cloud Pub/Sub API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1a of the Cloud Pub/Sub API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Pubsub service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Pubsub service in particular.) For reference information on specific calls in the Cloud Pub/Sub API, see the {Google::Apis::PubsubV1beta1a::PubsubService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-pubsub_v1beta1a`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-pubsub_v1beta1a`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/pubsub/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-pubsub_v1beta1a/google-apis-pubsub_v1beta1a.gemspec b/generated/google-apis-pubsub_v1beta1a/google-apis-pubsub_v1beta1a.gemspec index a2a10f10c..8b3b64284 100644 --- a/generated/google-apis-pubsub_v1beta1a/google-apis-pubsub_v1beta1a.gemspec +++ b/generated/google-apis-pubsub_v1beta1a/google-apis-pubsub_v1beta1a.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PubsubV1beta1a::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Pub/Sub API V1beta1a" + gem.summary = "Simple REST client for Cloud Pub/Sub API V1beta1a" gem.description = - "This is the legacy REST client for Cloud Pub/Sub API V1beta1a." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Pub/Sub API V1beta1a." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-pubsub_v1beta1a/lib/google/apis/pubsub_v1beta1a/gem_version.rb b/generated/google-apis-pubsub_v1beta1a/lib/google/apis/pubsub_v1beta1a/gem_version.rb index 2520ba2ca..bf1a0adf0 100644 --- a/generated/google-apis-pubsub_v1beta1a/lib/google/apis/pubsub_v1beta1a/gem_version.rb +++ b/generated/google-apis-pubsub_v1beta1a/lib/google/apis/pubsub_v1beta1a/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200807" diff --git a/generated/google-apis-pubsub_v1beta2/CHANGELOG.md b/generated/google-apis-pubsub_v1beta2/CHANGELOG.md index 94e49e5fc..a3e84bb4d 100644 --- a/generated/google-apis-pubsub_v1beta2/CHANGELOG.md +++ b/generated/google-apis-pubsub_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-pubsub_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201110 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-pubsub_v1beta2/OVERVIEW.md b/generated/google-apis-pubsub_v1beta2/OVERVIEW.md index adf547795..9d3c6e9e5 100644 --- a/generated/google-apis-pubsub_v1beta2/OVERVIEW.md +++ b/generated/google-apis-pubsub_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Pub/Sub API +# Simple REST client for version V1beta2 of the Cloud Pub/Sub API This is a simple client library for version V1beta2 of the Cloud Pub/Sub API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Pub/Sub API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Pubsub service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Pubsub service in particular.) For reference information on specific calls in the Cloud Pub/Sub API, see the {Google::Apis::PubsubV1beta2::PubsubService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-pubsub_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-pubsub_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/pubsub/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-pubsub_v1beta2/google-apis-pubsub_v1beta2.gemspec b/generated/google-apis-pubsub_v1beta2/google-apis-pubsub_v1beta2.gemspec index c0125d48c..c5fc9c6ed 100644 --- a/generated/google-apis-pubsub_v1beta2/google-apis-pubsub_v1beta2.gemspec +++ b/generated/google-apis-pubsub_v1beta2/google-apis-pubsub_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PubsubV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Pub/Sub API V1beta2" + gem.summary = "Simple REST client for Cloud Pub/Sub API V1beta2" gem.description = - "This is the legacy REST client for Cloud Pub/Sub API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Pub/Sub API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-pubsub_v1beta2/lib/google/apis/pubsub_v1beta2/gem_version.rb b/generated/google-apis-pubsub_v1beta2/lib/google/apis/pubsub_v1beta2/gem_version.rb index cac0cec90..47beb1a47 100644 --- a/generated/google-apis-pubsub_v1beta2/lib/google/apis/pubsub_v1beta2/gem_version.rb +++ b/generated/google-apis-pubsub_v1beta2/lib/google/apis/pubsub_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201110" diff --git a/generated/google-apis-pubsublite_v1/CHANGELOG.md b/generated/google-apis-pubsublite_v1/CHANGELOG.md index e953218f0..6bf044c5d 100644 --- a/generated/google-apis-pubsublite_v1/CHANGELOG.md +++ b/generated/google-apis-pubsublite_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-pubsublite_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200929 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-pubsublite_v1/OVERVIEW.md b/generated/google-apis-pubsublite_v1/OVERVIEW.md index 7cea66149..93644f3ad 100644 --- a/generated/google-apis-pubsublite_v1/OVERVIEW.md +++ b/generated/google-apis-pubsublite_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Pub/Sub Lite API +# Simple REST client for version V1 of the Pub/Sub Lite API This is a simple client library for version V1 of the Pub/Sub Lite API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Pub/Sub Lite API. It provi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Pubsublite service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Pubsublite service in particular.) For reference information on specific calls in the Pub/Sub Lite API, see the {Google::Apis::PubsubliteV1::PubsubLiteService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-pubsublite_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-pubsublite_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/pubsub/lite/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-pubsublite_v1/google-apis-pubsublite_v1.gemspec b/generated/google-apis-pubsublite_v1/google-apis-pubsublite_v1.gemspec index 80e498531..6b4e45ea4 100644 --- a/generated/google-apis-pubsublite_v1/google-apis-pubsublite_v1.gemspec +++ b/generated/google-apis-pubsublite_v1/google-apis-pubsublite_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::PubsubliteV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Pub/Sub Lite API V1" + gem.summary = "Simple REST client for Pub/Sub Lite API V1" gem.description = - "This is the legacy REST client for Pub/Sub Lite API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Pub/Sub Lite API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-pubsublite_v1/lib/google/apis/pubsublite_v1/gem_version.rb b/generated/google-apis-pubsublite_v1/lib/google/apis/pubsublite_v1/gem_version.rb index 46f804228..780881d05 100644 --- a/generated/google-apis-pubsublite_v1/lib/google/apis/pubsublite_v1/gem_version.rb +++ b/generated/google-apis-pubsublite_v1/lib/google/apis/pubsublite_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200929" diff --git a/generated/google-apis-realtimebidding_v1/CHANGELOG.md b/generated/google-apis-realtimebidding_v1/CHANGELOG.md index e19405205..574360211 100644 --- a/generated/google-apis-realtimebidding_v1/CHANGELOG.md +++ b/generated/google-apis-realtimebidding_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-realtimebidding_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201109 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-realtimebidding_v1/OVERVIEW.md b/generated/google-apis-realtimebidding_v1/OVERVIEW.md index 86218f35e..170d2342d 100644 --- a/generated/google-apis-realtimebidding_v1/OVERVIEW.md +++ b/generated/google-apis-realtimebidding_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Real-time Bidding API +# Simple REST client for version V1 of the Real-time Bidding API This is a simple client library for version V1 of the Real-time Bidding API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Real-time Bidding API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Realtimebidding service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Realtimebidding service in particular.) For reference information on specific calls in the Real-time Bidding API, see the {Google::Apis::RealtimebiddingV1::RealtimeBiddingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-realtimebidding_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-realtimebidding_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-realtimebidding_v1/google-apis-realtimebidding_v1.gemspec b/generated/google-apis-realtimebidding_v1/google-apis-realtimebidding_v1.gemspec index 7ddc19ea1..f8ee29811 100644 --- a/generated/google-apis-realtimebidding_v1/google-apis-realtimebidding_v1.gemspec +++ b/generated/google-apis-realtimebidding_v1/google-apis-realtimebidding_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RealtimebiddingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Real-time Bidding API V1" + gem.summary = "Simple REST client for Real-time Bidding API V1" gem.description = - "This is the legacy REST client for Real-time Bidding API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Real-time Bidding API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-realtimebidding_v1/lib/google/apis/realtimebidding_v1/gem_version.rb b/generated/google-apis-realtimebidding_v1/lib/google/apis/realtimebidding_v1/gem_version.rb index befe63f73..ff88be5f8 100644 --- a/generated/google-apis-realtimebidding_v1/lib/google/apis/realtimebidding_v1/gem_version.rb +++ b/generated/google-apis-realtimebidding_v1/lib/google/apis/realtimebidding_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201109" diff --git a/generated/google-apis-recommendationengine_v1beta1/CHANGELOG.md b/generated/google-apis-recommendationengine_v1beta1/CHANGELOG.md index d0f219a97..f5de7a3cf 100644 --- a/generated/google-apis-recommendationengine_v1beta1/CHANGELOG.md +++ b/generated/google-apis-recommendationengine_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-recommendationengine_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201212 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-recommendationengine_v1beta1/OVERVIEW.md b/generated/google-apis-recommendationengine_v1beta1/OVERVIEW.md index 49240feb5..7c1315a0d 100644 --- a/generated/google-apis-recommendationengine_v1beta1/OVERVIEW.md +++ b/generated/google-apis-recommendationengine_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Recommendations AI +# Simple REST client for version V1beta1 of the Recommendations AI This is a simple client library for version V1beta1 of the Recommendations AI. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Recommendations AI. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Recommendationengine service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Recommendationengine service in particular.) For reference information on specific calls in the Recommendations AI, see the {Google::Apis::RecommendationengineV1beta1::RecommendationsAIService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-recommendationengine_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-recommendationengine_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/recommendations-ai/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-recommendationengine_v1beta1/google-apis-recommendationengine_v1beta1.gemspec b/generated/google-apis-recommendationengine_v1beta1/google-apis-recommendationengine_v1beta1.gemspec index 3082af7ab..e67d41182 100644 --- a/generated/google-apis-recommendationengine_v1beta1/google-apis-recommendationengine_v1beta1.gemspec +++ b/generated/google-apis-recommendationengine_v1beta1/google-apis-recommendationengine_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RecommendationengineV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Recommendations AI V1beta1" + gem.summary = "Simple REST client for Recommendations AI V1beta1" gem.description = - "This is the legacy REST client for Recommendations AI V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Recommendations AI V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-recommendationengine_v1beta1/lib/google/apis/recommendationengine_v1beta1/gem_version.rb b/generated/google-apis-recommendationengine_v1beta1/lib/google/apis/recommendationengine_v1beta1/gem_version.rb index e08330812..3e5d1d9e3 100644 --- a/generated/google-apis-recommendationengine_v1beta1/lib/google/apis/recommendationengine_v1beta1/gem_version.rb +++ b/generated/google-apis-recommendationengine_v1beta1/lib/google/apis/recommendationengine_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201212" diff --git a/generated/google-apis-recommender_v1/CHANGELOG.md b/generated/google-apis-recommender_v1/CHANGELOG.md index 6e4f531ea..57523c62d 100644 --- a/generated/google-apis-recommender_v1/CHANGELOG.md +++ b/generated/google-apis-recommender_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-recommender_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-recommender_v1/OVERVIEW.md b/generated/google-apis-recommender_v1/OVERVIEW.md index bddc85b35..6b2cfee0a 100644 --- a/generated/google-apis-recommender_v1/OVERVIEW.md +++ b/generated/google-apis-recommender_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Recommender API +# Simple REST client for version V1 of the Recommender API This is a simple client library for version V1 of the Recommender API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Recommender API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Recommender service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Recommender service in particular.) For reference information on specific calls in the Recommender API, see the {Google::Apis::RecommenderV1::RecommenderService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-recommender_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-recommender_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/recommender/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-recommender_v1/google-apis-recommender_v1.gemspec b/generated/google-apis-recommender_v1/google-apis-recommender_v1.gemspec index bcbc7abdf..04a7efc5d 100644 --- a/generated/google-apis-recommender_v1/google-apis-recommender_v1.gemspec +++ b/generated/google-apis-recommender_v1/google-apis-recommender_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RecommenderV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Recommender API V1" + gem.summary = "Simple REST client for Recommender API V1" gem.description = - "This is the legacy REST client for Recommender API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Recommender API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-recommender_v1/lib/google/apis/recommender_v1/gem_version.rb b/generated/google-apis-recommender_v1/lib/google/apis/recommender_v1/gem_version.rb index 7f5664b19..679060001 100644 --- a/generated/google-apis-recommender_v1/lib/google/apis/recommender_v1/gem_version.rb +++ b/generated/google-apis-recommender_v1/lib/google/apis/recommender_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-recommender_v1beta1/CHANGELOG.md b/generated/google-apis-recommender_v1beta1/CHANGELOG.md index c59805ede..7ea736fdf 100644 --- a/generated/google-apis-recommender_v1beta1/CHANGELOG.md +++ b/generated/google-apis-recommender_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-recommender_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-recommender_v1beta1/OVERVIEW.md b/generated/google-apis-recommender_v1beta1/OVERVIEW.md index 0e24322eb..a78fc0297 100644 --- a/generated/google-apis-recommender_v1beta1/OVERVIEW.md +++ b/generated/google-apis-recommender_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Recommender API +# Simple REST client for version V1beta1 of the Recommender API This is a simple client library for version V1beta1 of the Recommender API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Recommender API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Recommender service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Recommender service in particular.) For reference information on specific calls in the Recommender API, see the {Google::Apis::RecommenderV1beta1::RecommenderService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-recommender_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-recommender_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/recommender/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-recommender_v1beta1/google-apis-recommender_v1beta1.gemspec b/generated/google-apis-recommender_v1beta1/google-apis-recommender_v1beta1.gemspec index 54f530a8d..46c162d79 100644 --- a/generated/google-apis-recommender_v1beta1/google-apis-recommender_v1beta1.gemspec +++ b/generated/google-apis-recommender_v1beta1/google-apis-recommender_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RecommenderV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Recommender API V1beta1" + gem.summary = "Simple REST client for Recommender API V1beta1" gem.description = - "This is the legacy REST client for Recommender API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Recommender API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-recommender_v1beta1/lib/google/apis/recommender_v1beta1/gem_version.rb b/generated/google-apis-recommender_v1beta1/lib/google/apis/recommender_v1beta1/gem_version.rb index 890a5c3ce..f47776544 100644 --- a/generated/google-apis-recommender_v1beta1/lib/google/apis/recommender_v1beta1/gem_version.rb +++ b/generated/google-apis-recommender_v1beta1/lib/google/apis/recommender_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-redis_v1/CHANGELOG.md b/generated/google-apis-redis_v1/CHANGELOG.md index e485f1e74..e0e53d35c 100644 --- a/generated/google-apis-redis_v1/CHANGELOG.md +++ b/generated/google-apis-redis_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-redis_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201210 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-redis_v1/OVERVIEW.md b/generated/google-apis-redis_v1/OVERVIEW.md index 4f1c82160..83c5a66e7 100644 --- a/generated/google-apis-redis_v1/OVERVIEW.md +++ b/generated/google-apis-redis_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Cloud Memorystore for Redis API +# Simple REST client for version V1 of the Google Cloud Memorystore for Redis API This is a simple client library for version V1 of the Google Cloud Memorystore for Redis API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Cloud Memorystore f * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Redis service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Redis service in particular.) For reference information on specific calls in the Google Cloud Memorystore for Redis API, see the {Google::Apis::RedisV1::CloudRedisService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-redis_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-redis_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/memorystore/docs/redis/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-redis_v1/google-apis-redis_v1.gemspec b/generated/google-apis-redis_v1/google-apis-redis_v1.gemspec index bc7735adc..6fdcdd885 100644 --- a/generated/google-apis-redis_v1/google-apis-redis_v1.gemspec +++ b/generated/google-apis-redis_v1/google-apis-redis_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RedisV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Cloud Memorystore for Redis API V1" + gem.summary = "Simple REST client for Google Cloud Memorystore for Redis API V1" gem.description = - "This is the legacy REST client for Google Cloud Memorystore for Redis API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Cloud Memorystore for Redis API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-redis_v1/lib/google/apis/redis_v1/gem_version.rb b/generated/google-apis-redis_v1/lib/google/apis/redis_v1/gem_version.rb index 384e6bf6f..b05b181f6 100644 --- a/generated/google-apis-redis_v1/lib/google/apis/redis_v1/gem_version.rb +++ b/generated/google-apis-redis_v1/lib/google/apis/redis_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201210" diff --git a/generated/google-apis-redis_v1beta1/CHANGELOG.md b/generated/google-apis-redis_v1beta1/CHANGELOG.md index d336af941..37e3c596b 100644 --- a/generated/google-apis-redis_v1beta1/CHANGELOG.md +++ b/generated/google-apis-redis_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-redis_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201210 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-redis_v1beta1/OVERVIEW.md b/generated/google-apis-redis_v1beta1/OVERVIEW.md index 304585235..843e9d521 100644 --- a/generated/google-apis-redis_v1beta1/OVERVIEW.md +++ b/generated/google-apis-redis_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Google Cloud Memorystore for Redis API +# Simple REST client for version V1beta1 of the Google Cloud Memorystore for Redis API This is a simple client library for version V1beta1 of the Google Cloud Memorystore for Redis API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Google Cloud Memoryst * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Redis service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Redis service in particular.) For reference information on specific calls in the Google Cloud Memorystore for Redis API, see the {Google::Apis::RedisV1beta1::CloudRedisService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-redis_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-redis_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/memorystore/docs/redis/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-redis_v1beta1/google-apis-redis_v1beta1.gemspec b/generated/google-apis-redis_v1beta1/google-apis-redis_v1beta1.gemspec index 3438b1aff..f34f64ea7 100644 --- a/generated/google-apis-redis_v1beta1/google-apis-redis_v1beta1.gemspec +++ b/generated/google-apis-redis_v1beta1/google-apis-redis_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RedisV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Cloud Memorystore for Redis API V1beta1" + gem.summary = "Simple REST client for Google Cloud Memorystore for Redis API V1beta1" gem.description = - "This is the legacy REST client for Google Cloud Memorystore for Redis API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Cloud Memorystore for Redis API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-redis_v1beta1/lib/google/apis/redis_v1beta1/gem_version.rb b/generated/google-apis-redis_v1beta1/lib/google/apis/redis_v1beta1/gem_version.rb index 1b65831f6..6c2cebef2 100644 --- a/generated/google-apis-redis_v1beta1/lib/google/apis/redis_v1beta1/gem_version.rb +++ b/generated/google-apis-redis_v1beta1/lib/google/apis/redis_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201210" diff --git a/generated/google-apis-remotebuildexecution_v1/CHANGELOG.md b/generated/google-apis-remotebuildexecution_v1/CHANGELOG.md index e6abb2111..df3e1fef3 100644 --- a/generated/google-apis-remotebuildexecution_v1/CHANGELOG.md +++ b/generated/google-apis-remotebuildexecution_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-remotebuildexecution_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-remotebuildexecution_v1/OVERVIEW.md b/generated/google-apis-remotebuildexecution_v1/OVERVIEW.md index f41bc2aca..f92d0f06d 100644 --- a/generated/google-apis-remotebuildexecution_v1/OVERVIEW.md +++ b/generated/google-apis-remotebuildexecution_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Remote Build Execution API +# Simple REST client for version V1 of the Remote Build Execution API This is a simple client library for version V1 of the Remote Build Execution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Remote Build Execution API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) For reference information on specific calls in the Remote Build Execution API, see the {Google::Apis::RemotebuildexecutionV1::RemoteBuildExecutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-remotebuildexecution_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-remotebuildexecution_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/remote-build-execution/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-remotebuildexecution_v1/google-apis-remotebuildexecution_v1.gemspec b/generated/google-apis-remotebuildexecution_v1/google-apis-remotebuildexecution_v1.gemspec index 52ac81cf8..37023c147 100644 --- a/generated/google-apis-remotebuildexecution_v1/google-apis-remotebuildexecution_v1.gemspec +++ b/generated/google-apis-remotebuildexecution_v1/google-apis-remotebuildexecution_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RemotebuildexecutionV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Remote Build Execution API V1" + gem.summary = "Simple REST client for Remote Build Execution API V1" gem.description = - "This is the legacy REST client for Remote Build Execution API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Remote Build Execution API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-remotebuildexecution_v1/lib/google/apis/remotebuildexecution_v1/gem_version.rb b/generated/google-apis-remotebuildexecution_v1/lib/google/apis/remotebuildexecution_v1/gem_version.rb index 304dc0cd3..4fc10559f 100644 --- a/generated/google-apis-remotebuildexecution_v1/lib/google/apis/remotebuildexecution_v1/gem_version.rb +++ b/generated/google-apis-remotebuildexecution_v1/lib/google/apis/remotebuildexecution_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-remotebuildexecution_v1alpha/CHANGELOG.md b/generated/google-apis-remotebuildexecution_v1alpha/CHANGELOG.md index 0cf266aea..04271d5f2 100644 --- a/generated/google-apis-remotebuildexecution_v1alpha/CHANGELOG.md +++ b/generated/google-apis-remotebuildexecution_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-remotebuildexecution_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-remotebuildexecution_v1alpha/OVERVIEW.md b/generated/google-apis-remotebuildexecution_v1alpha/OVERVIEW.md index d66ffaff8..4c4f77bd8 100644 --- a/generated/google-apis-remotebuildexecution_v1alpha/OVERVIEW.md +++ b/generated/google-apis-remotebuildexecution_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Remote Build Execution API +# Simple REST client for version V1alpha of the Remote Build Execution API This is a simple client library for version V1alpha of the Remote Build Execution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Remote Build Executio * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) For reference information on specific calls in the Remote Build Execution API, see the {Google::Apis::RemotebuildexecutionV1alpha::RemoteBuildExecutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-remotebuildexecution_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-remotebuildexecution_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/remote-build-execution/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-remotebuildexecution_v1alpha/google-apis-remotebuildexecution_v1alpha.gemspec b/generated/google-apis-remotebuildexecution_v1alpha/google-apis-remotebuildexecution_v1alpha.gemspec index 4521a2379..52a7cb4ef 100644 --- a/generated/google-apis-remotebuildexecution_v1alpha/google-apis-remotebuildexecution_v1alpha.gemspec +++ b/generated/google-apis-remotebuildexecution_v1alpha/google-apis-remotebuildexecution_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RemotebuildexecutionV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Remote Build Execution API V1alpha" + gem.summary = "Simple REST client for Remote Build Execution API V1alpha" gem.description = - "This is the legacy REST client for Remote Build Execution API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Remote Build Execution API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-remotebuildexecution_v1alpha/lib/google/apis/remotebuildexecution_v1alpha/gem_version.rb b/generated/google-apis-remotebuildexecution_v1alpha/lib/google/apis/remotebuildexecution_v1alpha/gem_version.rb index a2c6b56af..1f080032c 100644 --- a/generated/google-apis-remotebuildexecution_v1alpha/lib/google/apis/remotebuildexecution_v1alpha/gem_version.rb +++ b/generated/google-apis-remotebuildexecution_v1alpha/lib/google/apis/remotebuildexecution_v1alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-remotebuildexecution_v2/CHANGELOG.md b/generated/google-apis-remotebuildexecution_v2/CHANGELOG.md index 3e622e0b7..4aa1fe17a 100644 --- a/generated/google-apis-remotebuildexecution_v2/CHANGELOG.md +++ b/generated/google-apis-remotebuildexecution_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-remotebuildexecution_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-remotebuildexecution_v2/OVERVIEW.md b/generated/google-apis-remotebuildexecution_v2/OVERVIEW.md index 755ce510f..599048f4b 100644 --- a/generated/google-apis-remotebuildexecution_v2/OVERVIEW.md +++ b/generated/google-apis-remotebuildexecution_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Remote Build Execution API +# Simple REST client for version V2 of the Remote Build Execution API This is a simple client library for version V2 of the Remote Build Execution API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Remote Build Execution API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Remotebuildexecution service in particular.) For reference information on specific calls in the Remote Build Execution API, see the {Google::Apis::RemotebuildexecutionV2::RemoteBuildExecutionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-remotebuildexecution_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-remotebuildexecution_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/remote-build-execution/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-remotebuildexecution_v2/google-apis-remotebuildexecution_v2.gemspec b/generated/google-apis-remotebuildexecution_v2/google-apis-remotebuildexecution_v2.gemspec index 2d7972242..6a85c92c8 100644 --- a/generated/google-apis-remotebuildexecution_v2/google-apis-remotebuildexecution_v2.gemspec +++ b/generated/google-apis-remotebuildexecution_v2/google-apis-remotebuildexecution_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RemotebuildexecutionV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Remote Build Execution API V2" + gem.summary = "Simple REST client for Remote Build Execution API V2" gem.description = - "This is the legacy REST client for Remote Build Execution API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Remote Build Execution API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-remotebuildexecution_v2/lib/google/apis/remotebuildexecution_v2/gem_version.rb b/generated/google-apis-remotebuildexecution_v2/lib/google/apis/remotebuildexecution_v2/gem_version.rb index e06bf8965..a4e7767f2 100644 --- a/generated/google-apis-remotebuildexecution_v2/lib/google/apis/remotebuildexecution_v2/gem_version.rb +++ b/generated/google-apis-remotebuildexecution_v2/lib/google/apis/remotebuildexecution_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-reseller_v1/CHANGELOG.md b/generated/google-apis-reseller_v1/CHANGELOG.md index 628a85277..dd96e426b 100644 --- a/generated/google-apis-reseller_v1/CHANGELOG.md +++ b/generated/google-apis-reseller_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-reseller_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201129 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-reseller_v1/OVERVIEW.md b/generated/google-apis-reseller_v1/OVERVIEW.md index d0083cd4e..b52d84efc 100644 --- a/generated/google-apis-reseller_v1/OVERVIEW.md +++ b/generated/google-apis-reseller_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Workspace Reseller API +# Simple REST client for version V1 of the Google Workspace Reseller API This is a simple client library for version V1 of the Google Workspace Reseller API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Workspace Reseller * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Reseller service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Reseller service in particular.) For reference information on specific calls in the Google Workspace Reseller API, see the {Google::Apis::ResellerV1::ResellerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-reseller_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-reseller_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/google-apps/reseller/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-reseller_v1/google-apis-reseller_v1.gemspec b/generated/google-apis-reseller_v1/google-apis-reseller_v1.gemspec index 81b204934..6efd97987 100644 --- a/generated/google-apis-reseller_v1/google-apis-reseller_v1.gemspec +++ b/generated/google-apis-reseller_v1/google-apis-reseller_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ResellerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Workspace Reseller API V1" + gem.summary = "Simple REST client for Google Workspace Reseller API V1" gem.description = - "This is the legacy REST client for Google Workspace Reseller API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Workspace Reseller API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-reseller_v1/lib/google/apis/reseller_v1/gem_version.rb b/generated/google-apis-reseller_v1/lib/google/apis/reseller_v1/gem_version.rb index 45a2beeda..1ba1168b3 100644 --- a/generated/google-apis-reseller_v1/lib/google/apis/reseller_v1/gem_version.rb +++ b/generated/google-apis-reseller_v1/lib/google/apis/reseller_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201129" diff --git a/generated/google-apis-run_v1/CHANGELOG.md b/generated/google-apis-run_v1/CHANGELOG.md index e493df43f..7b389d868 100644 --- a/generated/google-apis-run_v1/CHANGELOG.md +++ b/generated/google-apis-run_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-run_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-run_v1/OVERVIEW.md b/generated/google-apis-run_v1/OVERVIEW.md index f2fc674c6..5b4d28d7c 100644 --- a/generated/google-apis-run_v1/OVERVIEW.md +++ b/generated/google-apis-run_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Run Admin API +# Simple REST client for version V1 of the Cloud Run Admin API This is a simple client library for version V1 of the Cloud Run Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Run Admin API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Run service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Run service in particular.) For reference information on specific calls in the Cloud Run Admin API, see the {Google::Apis::RunV1::CloudRunService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-run_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-run_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/run/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-run_v1/google-apis-run_v1.gemspec b/generated/google-apis-run_v1/google-apis-run_v1.gemspec index 2164a4b08..cabb8e146 100644 --- a/generated/google-apis-run_v1/google-apis-run_v1.gemspec +++ b/generated/google-apis-run_v1/google-apis-run_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RunV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Run Admin API V1" + gem.summary = "Simple REST client for Cloud Run Admin API V1" gem.description = - "This is the legacy REST client for Cloud Run Admin API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Run Admin API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-run_v1/lib/google/apis/run_v1/gem_version.rb b/generated/google-apis-run_v1/lib/google/apis/run_v1/gem_version.rb index 2be4c68fb..dd96b0a0c 100644 --- a/generated/google-apis-run_v1/lib/google/apis/run_v1/gem_version.rb +++ b/generated/google-apis-run_v1/lib/google/apis/run_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-run_v1alpha1/CHANGELOG.md b/generated/google-apis-run_v1alpha1/CHANGELOG.md index 69bd78242..146cdb9f4 100644 --- a/generated/google-apis-run_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-run_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-run_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201113 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-run_v1alpha1/OVERVIEW.md b/generated/google-apis-run_v1alpha1/OVERVIEW.md index 1a96e25d7..41a951e9c 100644 --- a/generated/google-apis-run_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-run_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Cloud Run Admin API +# Simple REST client for version V1alpha1 of the Cloud Run Admin API This is a simple client library for version V1alpha1 of the Cloud Run Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Cloud Run Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Run service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Run service in particular.) For reference information on specific calls in the Cloud Run Admin API, see the {Google::Apis::RunV1alpha1::CloudRunService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-run_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-run_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/run/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-run_v1alpha1/google-apis-run_v1alpha1.gemspec b/generated/google-apis-run_v1alpha1/google-apis-run_v1alpha1.gemspec index d85794bc8..445909075 100644 --- a/generated/google-apis-run_v1alpha1/google-apis-run_v1alpha1.gemspec +++ b/generated/google-apis-run_v1alpha1/google-apis-run_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RunV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Run Admin API V1alpha1" + gem.summary = "Simple REST client for Cloud Run Admin API V1alpha1" gem.description = - "This is the legacy REST client for Cloud Run Admin API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Run Admin API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-run_v1alpha1/lib/google/apis/run_v1alpha1/gem_version.rb b/generated/google-apis-run_v1alpha1/lib/google/apis/run_v1alpha1/gem_version.rb index 95199132c..bf5008436 100644 --- a/generated/google-apis-run_v1alpha1/lib/google/apis/run_v1alpha1/gem_version.rb +++ b/generated/google-apis-run_v1alpha1/lib/google/apis/run_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201113" diff --git a/generated/google-apis-run_v1beta1/CHANGELOG.md b/generated/google-apis-run_v1beta1/CHANGELOG.md index 836b219c8..5755560b1 100644 --- a/generated/google-apis-run_v1beta1/CHANGELOG.md +++ b/generated/google-apis-run_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-run_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200814 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-run_v1beta1/OVERVIEW.md b/generated/google-apis-run_v1beta1/OVERVIEW.md index a2ff816e0..3cf7d2cdc 100644 --- a/generated/google-apis-run_v1beta1/OVERVIEW.md +++ b/generated/google-apis-run_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Run Admin API +# Simple REST client for version V1beta1 of the Cloud Run Admin API This is a simple client library for version V1beta1 of the Cloud Run Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Run Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Run service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Run service in particular.) For reference information on specific calls in the Cloud Run Admin API, see the {Google::Apis::RunV1beta1::CloudRunService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-run_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-run_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/run/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-run_v1beta1/google-apis-run_v1beta1.gemspec b/generated/google-apis-run_v1beta1/google-apis-run_v1beta1.gemspec index 555ac739a..04e4b8ef4 100644 --- a/generated/google-apis-run_v1beta1/google-apis-run_v1beta1.gemspec +++ b/generated/google-apis-run_v1beta1/google-apis-run_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RunV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Run Admin API V1beta1" + gem.summary = "Simple REST client for Cloud Run Admin API V1beta1" gem.description = - "This is the legacy REST client for Cloud Run Admin API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Run Admin API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-run_v1beta1/lib/google/apis/run_v1beta1/gem_version.rb b/generated/google-apis-run_v1beta1/lib/google/apis/run_v1beta1/gem_version.rb index 303419fcd..0078229e6 100644 --- a/generated/google-apis-run_v1beta1/lib/google/apis/run_v1beta1/gem_version.rb +++ b/generated/google-apis-run_v1beta1/lib/google/apis/run_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200814" diff --git a/generated/google-apis-runtimeconfig_v1/CHANGELOG.md b/generated/google-apis-runtimeconfig_v1/CHANGELOG.md index f9afa2ae5..16ca2f230 100644 --- a/generated/google-apis-runtimeconfig_v1/CHANGELOG.md +++ b/generated/google-apis-runtimeconfig_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-runtimeconfig_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200803 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-runtimeconfig_v1/OVERVIEW.md b/generated/google-apis-runtimeconfig_v1/OVERVIEW.md index 7fbfbaa97..c3574030f 100644 --- a/generated/google-apis-runtimeconfig_v1/OVERVIEW.md +++ b/generated/google-apis-runtimeconfig_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Runtime Configuration API +# Simple REST client for version V1 of the Cloud Runtime Configuration API This is a simple client library for version V1 of the Cloud Runtime Configuration API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Runtime Configuratio * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Runtimeconfig service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Runtimeconfig service in particular.) For reference information on specific calls in the Cloud Runtime Configuration API, see the {Google::Apis::RuntimeconfigV1::CloudRuntimeConfigService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-runtimeconfig_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-runtimeconfig_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/deployment-manager/runtime-configurator/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-runtimeconfig_v1/google-apis-runtimeconfig_v1.gemspec b/generated/google-apis-runtimeconfig_v1/google-apis-runtimeconfig_v1.gemspec index 8ec827cf9..73982c283 100644 --- a/generated/google-apis-runtimeconfig_v1/google-apis-runtimeconfig_v1.gemspec +++ b/generated/google-apis-runtimeconfig_v1/google-apis-runtimeconfig_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RuntimeconfigV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Runtime Configuration API V1" + gem.summary = "Simple REST client for Cloud Runtime Configuration API V1" gem.description = - "This is the legacy REST client for Cloud Runtime Configuration API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Runtime Configuration API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-runtimeconfig_v1/lib/google/apis/runtimeconfig_v1/gem_version.rb b/generated/google-apis-runtimeconfig_v1/lib/google/apis/runtimeconfig_v1/gem_version.rb index a4089fb1c..09d2225ed 100644 --- a/generated/google-apis-runtimeconfig_v1/lib/google/apis/runtimeconfig_v1/gem_version.rb +++ b/generated/google-apis-runtimeconfig_v1/lib/google/apis/runtimeconfig_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200803" diff --git a/generated/google-apis-runtimeconfig_v1beta1/CHANGELOG.md b/generated/google-apis-runtimeconfig_v1beta1/CHANGELOG.md index 5d2e10001..78630d3f0 100644 --- a/generated/google-apis-runtimeconfig_v1beta1/CHANGELOG.md +++ b/generated/google-apis-runtimeconfig_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-runtimeconfig_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201109 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-runtimeconfig_v1beta1/OVERVIEW.md b/generated/google-apis-runtimeconfig_v1beta1/OVERVIEW.md index ce4b77bd0..1a0819bf6 100644 --- a/generated/google-apis-runtimeconfig_v1beta1/OVERVIEW.md +++ b/generated/google-apis-runtimeconfig_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Runtime Configuration API +# Simple REST client for version V1beta1 of the Cloud Runtime Configuration API This is a simple client library for version V1beta1 of the Cloud Runtime Configuration API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Runtime Configu * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Runtimeconfig service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Runtimeconfig service in particular.) For reference information on specific calls in the Cloud Runtime Configuration API, see the {Google::Apis::RuntimeconfigV1beta1::CloudRuntimeConfigService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-runtimeconfig_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-runtimeconfig_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/deployment-manager/runtime-configurator/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-runtimeconfig_v1beta1/google-apis-runtimeconfig_v1beta1.gemspec b/generated/google-apis-runtimeconfig_v1beta1/google-apis-runtimeconfig_v1beta1.gemspec index 463c871de..e7de4266f 100644 --- a/generated/google-apis-runtimeconfig_v1beta1/google-apis-runtimeconfig_v1beta1.gemspec +++ b/generated/google-apis-runtimeconfig_v1beta1/google-apis-runtimeconfig_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::RuntimeconfigV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Runtime Configuration API V1beta1" + gem.summary = "Simple REST client for Cloud Runtime Configuration API V1beta1" gem.description = - "This is the legacy REST client for Cloud Runtime Configuration API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Runtime Configuration API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-runtimeconfig_v1beta1/lib/google/apis/runtimeconfig_v1beta1/gem_version.rb b/generated/google-apis-runtimeconfig_v1beta1/lib/google/apis/runtimeconfig_v1beta1/gem_version.rb index 63729d20e..145bb6dc3 100644 --- a/generated/google-apis-runtimeconfig_v1beta1/lib/google/apis/runtimeconfig_v1beta1/gem_version.rb +++ b/generated/google-apis-runtimeconfig_v1beta1/lib/google/apis/runtimeconfig_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201109" diff --git a/generated/google-apis-safebrowsing_v4/CHANGELOG.md b/generated/google-apis-safebrowsing_v4/CHANGELOG.md index 110971324..748ddd5e0 100644 --- a/generated/google-apis-safebrowsing_v4/CHANGELOG.md +++ b/generated/google-apis-safebrowsing_v4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-safebrowsing_v4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201213 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20210105 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-safebrowsing_v4/OVERVIEW.md b/generated/google-apis-safebrowsing_v4/OVERVIEW.md index 08f01f504..ff0a67359 100644 --- a/generated/google-apis-safebrowsing_v4/OVERVIEW.md +++ b/generated/google-apis-safebrowsing_v4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V4 of the Safe Browsing API +# Simple REST client for version V4 of the Safe Browsing API This is a simple client library for version V4 of the Safe Browsing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V4 of the Safe Browsing API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Safebrowsing service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Safebrowsing service in particular.) For reference information on specific calls in the Safe Browsing API, see the {Google::Apis::SafebrowsingV4::SafebrowsingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-safebrowsing_v4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-safebrowsing_v4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/safe-browsing/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-safebrowsing_v4/google-apis-safebrowsing_v4.gemspec b/generated/google-apis-safebrowsing_v4/google-apis-safebrowsing_v4.gemspec index 854f91073..9f41c415f 100644 --- a/generated/google-apis-safebrowsing_v4/google-apis-safebrowsing_v4.gemspec +++ b/generated/google-apis-safebrowsing_v4/google-apis-safebrowsing_v4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SafebrowsingV4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Safe Browsing API V4" + gem.summary = "Simple REST client for Safe Browsing API V4" gem.description = - "This is the legacy REST client for Safe Browsing API V4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Safe Browsing API V4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/classes.rb b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/classes.rb index c60847e6e..14d5a0e34 100644 --- a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/classes.rb +++ b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/classes.rb @@ -22,8 +22,25 @@ module Google module Apis module SafebrowsingV4 + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. + class GoogleProtobufEmpty + include Google::Apis::Core::Hashable + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + end + end + # The expected state of a client's local database. - class Checksum + class GoogleSecuritySafebrowsingV4Checksum include Google::Apis::Core::Hashable # The SHA256 hash of the client state; that is, of the sorted list of all hashes @@ -44,7 +61,7 @@ module Google end # The client metadata associated with Safe Browsing API requests. - class ClientInfo + class GoogleSecuritySafebrowsingV4ClientInfo include Google::Apis::Core::Hashable # A client ID that (hopefully) uniquely identifies the client implementation of @@ -69,8 +86,79 @@ module Google end end + # Describes a Safe Browsing API update request. Clients can request updates for + # multiple lists in a single request. NOTE: Field index 2 is unused. NEXT: 5 + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest + include Google::Apis::Core::Hashable + + # The client metadata associated with Safe Browsing API requests. + # Corresponds to the JSON property `client` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo] + attr_accessor :client + + # The requested threat list updates. + # Corresponds to the JSON property `listUpdateRequests` + # @return [Array] + attr_accessor :list_update_requests + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @client = args[:client] if args.key?(:client) + @list_update_requests = args[:list_update_requests] if args.key?(:list_update_requests) + end + end + + # A single list update request. + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequest + include Google::Apis::Core::Hashable + + # The constraints for this update. + # Corresponds to the JSON property `constraints` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints] + attr_accessor :constraints + + # The type of platform at risk by entries present in the list. + # Corresponds to the JSON property `platformType` + # @return [String] + attr_accessor :platform_type + + # The current state of the client for the requested list (the encrypted client + # state that was received from the last successful list update). + # Corresponds to the JSON property `state` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :state + + # The types of entries present in the list. + # Corresponds to the JSON property `threatEntryType` + # @return [String] + attr_accessor :threat_entry_type + + # The type of threat posed by entries present in the list. + # Corresponds to the JSON property `threatType` + # @return [String] + attr_accessor :threat_type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @constraints = args[:constraints] if args.key?(:constraints) + @platform_type = args[:platform_type] if args.key?(:platform_type) + @state = args[:state] if args.key?(:state) + @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) + @threat_type = args[:threat_type] if args.key?(:threat_type) + end + end + # The constraints for this update. - class Constraints + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints include Google::Apis::Core::Hashable # A client's physical location, expressed as a ISO 31166-1 alpha-2 region code. @@ -124,56 +212,13 @@ module Google end end - # A generic empty message that you can re-use to avoid defining duplicated empty - # messages in your APIs. A typical example is to use it as the request or the - # response type of an API method. For instance: service Foo ` rpc Bar(google. - # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for - # `Empty` is empty JSON object ````. - class Empty - include Google::Apis::Core::Hashable - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - end - end - - # Describes a Safe Browsing API update request. Clients can request updates for - # multiple lists in a single request. NOTE: Field index 2 is unused. NEXT: 5 - class FetchThreatListUpdatesRequest - include Google::Apis::Core::Hashable - - # The client metadata associated with Safe Browsing API requests. - # Corresponds to the JSON property `client` - # @return [Google::Apis::SafebrowsingV4::ClientInfo] - attr_accessor :client - - # The requested threat list updates. - # Corresponds to the JSON property `listUpdateRequests` - # @return [Array] - attr_accessor :list_update_requests - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @client = args[:client] if args.key?(:client) - @list_update_requests = args[:list_update_requests] if args.key?(:list_update_requests) - end - end - # - class FetchThreatListUpdatesResponse + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse include Google::Apis::Core::Hashable # The list updates requested by the clients. # Corresponds to the JSON property `listUpdateResponses` - # @return [Array] + # @return [Array] attr_accessor :list_update_responses # The minimum duration the client must wait before issuing any update request. @@ -193,200 +238,19 @@ module Google end end - # Request to return full hashes matched by the provided hash prefixes. - class FindFullHashesRequest - include Google::Apis::Core::Hashable - - # The client metadata associated with Safe Browsing API requests. - # Corresponds to the JSON property `apiClient` - # @return [Google::Apis::SafebrowsingV4::ClientInfo] - attr_accessor :api_client - - # The client metadata associated with Safe Browsing API requests. - # Corresponds to the JSON property `client` - # @return [Google::Apis::SafebrowsingV4::ClientInfo] - attr_accessor :client - - # The current client states for each of the client's local threat lists. - # Corresponds to the JSON property `clientStates` - # @return [Array] - attr_accessor :client_states - - # The information regarding one or more threats that a client submits when - # checking for matches in threat lists. - # Corresponds to the JSON property `threatInfo` - # @return [Google::Apis::SafebrowsingV4::ThreatInfo] - attr_accessor :threat_info - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @api_client = args[:api_client] if args.key?(:api_client) - @client = args[:client] if args.key?(:client) - @client_states = args[:client_states] if args.key?(:client_states) - @threat_info = args[:threat_info] if args.key?(:threat_info) - end - end - - # - class FindFullHashesResponse - include Google::Apis::Core::Hashable - - # The full hashes that matched the requested prefixes. - # Corresponds to the JSON property `matches` - # @return [Array] - attr_accessor :matches - - # The minimum duration the client must wait before issuing any find hashes - # request. If this field is not set, clients can issue a request as soon as they - # want. - # Corresponds to the JSON property `minimumWaitDuration` - # @return [String] - attr_accessor :minimum_wait_duration - - # For requested entities that did not match the threat list, how long to cache - # the response. - # Corresponds to the JSON property `negativeCacheDuration` - # @return [String] - attr_accessor :negative_cache_duration - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @matches = args[:matches] if args.key?(:matches) - @minimum_wait_duration = args[:minimum_wait_duration] if args.key?(:minimum_wait_duration) - @negative_cache_duration = args[:negative_cache_duration] if args.key?(:negative_cache_duration) - end - end - - # Request to check entries against lists. - class FindThreatMatchesRequest - include Google::Apis::Core::Hashable - - # The client metadata associated with Safe Browsing API requests. - # Corresponds to the JSON property `client` - # @return [Google::Apis::SafebrowsingV4::ClientInfo] - attr_accessor :client - - # The information regarding one or more threats that a client submits when - # checking for matches in threat lists. - # Corresponds to the JSON property `threatInfo` - # @return [Google::Apis::SafebrowsingV4::ThreatInfo] - attr_accessor :threat_info - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @client = args[:client] if args.key?(:client) - @threat_info = args[:threat_info] if args.key?(:threat_info) - end - end - - # - class FindThreatMatchesResponse - include Google::Apis::Core::Hashable - - # The threat list matches. - # Corresponds to the JSON property `matches` - # @return [Array] - attr_accessor :matches - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @matches = args[:matches] if args.key?(:matches) - end - end - - # - class ListThreatListsResponse - include Google::Apis::Core::Hashable - - # The lists available for download by the client. - # Corresponds to the JSON property `threatLists` - # @return [Array] - attr_accessor :threat_lists - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @threat_lists = args[:threat_lists] if args.key?(:threat_lists) - end - end - - # A single list update request. - class ListUpdateRequest - include Google::Apis::Core::Hashable - - # The constraints for this update. - # Corresponds to the JSON property `constraints` - # @return [Google::Apis::SafebrowsingV4::Constraints] - attr_accessor :constraints - - # The type of platform at risk by entries present in the list. - # Corresponds to the JSON property `platformType` - # @return [String] - attr_accessor :platform_type - - # The current state of the client for the requested list (the encrypted client - # state that was received from the last successful list update). - # Corresponds to the JSON property `state` - # NOTE: Values are automatically base64 encoded/decoded in the client library. - # @return [String] - attr_accessor :state - - # The types of entries present in the list. - # Corresponds to the JSON property `threatEntryType` - # @return [String] - attr_accessor :threat_entry_type - - # The type of threat posed by entries present in the list. - # Corresponds to the JSON property `threatType` - # @return [String] - attr_accessor :threat_type - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @constraints = args[:constraints] if args.key?(:constraints) - @platform_type = args[:platform_type] if args.key?(:platform_type) - @state = args[:state] if args.key?(:state) - @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) - @threat_type = args[:threat_type] if args.key?(:threat_type) - end - end - # An update to an individual list. - class ListUpdateResponse + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponseListUpdateResponse include Google::Apis::Core::Hashable # A set of entries to add to a local threat type's list. Repeated to allow for a # combination of compressed and raw data to be sent in a single response. # Corresponds to the JSON property `additions` - # @return [Array] + # @return [Array] attr_accessor :additions # The expected state of a client's local database. # Corresponds to the JSON property `checksum` - # @return [Google::Apis::SafebrowsingV4::Checksum] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4Checksum] attr_accessor :checksum # The new client state, in encrypted format. Opaque to clients. @@ -403,7 +267,7 @@ module Google # A set of entries to remove from a local threat type's list. In practice, this # field is empty or contains exactly one ThreatEntrySet. # Corresponds to the JSON property `removals` - # @return [Array] + # @return [Array] attr_accessor :removals # The type of response. This may indicate that an action is required by the @@ -439,21 +303,30 @@ module Google end end - # A single metadata entry. - class MetadataEntry + # Request to return full hashes matched by the provided hash prefixes. + class GoogleSecuritySafebrowsingV4FindFullHashesRequest include Google::Apis::Core::Hashable - # The metadata entry key. For JSON requests, the key is base64-encoded. - # Corresponds to the JSON property `key` - # NOTE: Values are automatically base64 encoded/decoded in the client library. - # @return [String] - attr_accessor :key + # The client metadata associated with Safe Browsing API requests. + # Corresponds to the JSON property `apiClient` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo] + attr_accessor :api_client - # The metadata entry value. For JSON requests, the value is base64-encoded. - # Corresponds to the JSON property `value` - # NOTE: Values are automatically base64 encoded/decoded in the client library. - # @return [String] - attr_accessor :value + # The client metadata associated with Safe Browsing API requests. + # Corresponds to the JSON property `client` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo] + attr_accessor :client + + # The current client states for each of the client's local threat lists. + # Corresponds to the JSON property `clientStates` + # @return [Array] + attr_accessor :client_states + + # The information regarding one or more threats that a client submits when + # checking for matches in threat lists. + # Corresponds to the JSON property `threatInfo` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo] + attr_accessor :threat_info def initialize(**args) update!(**args) @@ -461,8 +334,108 @@ module Google # Update properties of this object def update!(**args) - @key = args[:key] if args.key?(:key) - @value = args[:value] if args.key?(:value) + @api_client = args[:api_client] if args.key?(:api_client) + @client = args[:client] if args.key?(:client) + @client_states = args[:client_states] if args.key?(:client_states) + @threat_info = args[:threat_info] if args.key?(:threat_info) + end + end + + # + class GoogleSecuritySafebrowsingV4FindFullHashesResponse + include Google::Apis::Core::Hashable + + # The full hashes that matched the requested prefixes. + # Corresponds to the JSON property `matches` + # @return [Array] + attr_accessor :matches + + # The minimum duration the client must wait before issuing any find hashes + # request. If this field is not set, clients can issue a request as soon as they + # want. + # Corresponds to the JSON property `minimumWaitDuration` + # @return [String] + attr_accessor :minimum_wait_duration + + # For requested entities that did not match the threat list, how long to cache + # the response. + # Corresponds to the JSON property `negativeCacheDuration` + # @return [String] + attr_accessor :negative_cache_duration + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @matches = args[:matches] if args.key?(:matches) + @minimum_wait_duration = args[:minimum_wait_duration] if args.key?(:minimum_wait_duration) + @negative_cache_duration = args[:negative_cache_duration] if args.key?(:negative_cache_duration) + end + end + + # Request to check entries against lists. + class GoogleSecuritySafebrowsingV4FindThreatMatchesRequest + include Google::Apis::Core::Hashable + + # The client metadata associated with Safe Browsing API requests. + # Corresponds to the JSON property `client` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo] + attr_accessor :client + + # The information regarding one or more threats that a client submits when + # checking for matches in threat lists. + # Corresponds to the JSON property `threatInfo` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo] + attr_accessor :threat_info + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @client = args[:client] if args.key?(:client) + @threat_info = args[:threat_info] if args.key?(:threat_info) + end + end + + # + class GoogleSecuritySafebrowsingV4FindThreatMatchesResponse + include Google::Apis::Core::Hashable + + # The threat list matches. + # Corresponds to the JSON property `matches` + # @return [Array] + attr_accessor :matches + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @matches = args[:matches] if args.key?(:matches) + end + end + + # + class GoogleSecuritySafebrowsingV4ListThreatListsResponse + include Google::Apis::Core::Hashable + + # The lists available for download by the client. + # Corresponds to the JSON property `threatLists` + # @return [Array] + attr_accessor :threat_lists + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @threat_lists = args[:threat_lists] if args.key?(:threat_lists) end end @@ -472,7 +445,7 @@ module Google # popular URL. Used for sending ThreatEntrySet to clients that do not support # compression, or when sending non-4-byte hashes to clients that do support # compression. - class RawHashes + class GoogleSecuritySafebrowsingV4RawHashes include Google::Apis::Core::Hashable # The number of bytes for each prefix encoded below. This field can be anywhere @@ -500,7 +473,7 @@ module Google end # A set of raw indices to remove from a local list. - class RawIndices + class GoogleSecuritySafebrowsingV4RawIndices include Google::Apis::Core::Hashable # The indices to remove from a lexicographically-sorted local list. @@ -520,7 +493,7 @@ module Google # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or # compressed removal indices. - class RiceDeltaEncoding + class GoogleSecuritySafebrowsingV4RiceDeltaEncoding include Google::Apis::Core::Hashable # The encoded deltas that are encoded using the Golomb-Rice coder. @@ -564,7 +537,7 @@ module Google # An individual threat; for example, a malicious URL or its hash representation. # Only one of these fields should be set. - class ThreatEntry + class GoogleSecuritySafebrowsingV4ThreatEntry include Google::Apis::Core::Hashable # The digest of an executable in SHA256 format. The API supports both binary and @@ -600,12 +573,12 @@ module Google # The metadata associated with a specific threat entry. The client is expected # to know the metadata key/value pairs associated with each threat type. - class ThreatEntryMetadata + class GoogleSecuritySafebrowsingV4ThreatEntryMetadata include Google::Apis::Core::Hashable # The metadata entries. # Corresponds to the JSON property `entries` - # @return [Array] + # @return [Array] attr_accessor :entries def initialize(**args) @@ -618,9 +591,36 @@ module Google end end + # A single metadata entry. + class GoogleSecuritySafebrowsingV4ThreatEntryMetadataMetadataEntry + include Google::Apis::Core::Hashable + + # The metadata entry key. For JSON requests, the key is base64-encoded. + # Corresponds to the JSON property `key` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :key + + # The metadata entry value. For JSON requests, the value is base64-encoded. + # Corresponds to the JSON property `value` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :value + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @key = args[:key] if args.key?(:key) + @value = args[:value] if args.key?(:value) + end + end + # A set of threats that should be added or removed from a client's local # database. - class ThreatEntrySet + class GoogleSecuritySafebrowsingV4ThreatEntrySet include Google::Apis::Core::Hashable # The compression type for the entries in this set. @@ -635,24 +635,24 @@ module Google # compression, or when sending non-4-byte hashes to clients that do support # compression. # Corresponds to the JSON property `rawHashes` - # @return [Google::Apis::SafebrowsingV4::RawHashes] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawHashes] attr_accessor :raw_hashes # A set of raw indices to remove from a local list. # Corresponds to the JSON property `rawIndices` - # @return [Google::Apis::SafebrowsingV4::RawIndices] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawIndices] attr_accessor :raw_indices # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or # compressed removal indices. # Corresponds to the JSON property `riceHashes` - # @return [Google::Apis::SafebrowsingV4::RiceDeltaEncoding] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding] attr_accessor :rice_hashes # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or # compressed removal indices. # Corresponds to the JSON property `riceIndices` - # @return [Google::Apis::SafebrowsingV4::RiceDeltaEncoding] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding] attr_accessor :rice_indices def initialize(**args) @@ -670,18 +670,18 @@ module Google end # - class ThreatHit + class GoogleSecuritySafebrowsingV4ThreatHit include Google::Apis::Core::Hashable # The client metadata associated with Safe Browsing API requests. # Corresponds to the JSON property `clientInfo` - # @return [Google::Apis::SafebrowsingV4::ClientInfo] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo] attr_accessor :client_info # An individual threat; for example, a malicious URL or its hash representation. # Only one of these fields should be set. # Corresponds to the JSON property `entry` - # @return [Google::Apis::SafebrowsingV4::ThreatEntry] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry] attr_accessor :entry # The platform type reported. @@ -691,7 +691,7 @@ module Google # The resources related to the threat hit. # Corresponds to the JSON property `resources` - # @return [Array] + # @return [Array] attr_accessor :resources # The threat type reported. @@ -701,7 +701,7 @@ module Google # Details about the user that encountered the threat. # Corresponds to the JSON property `userInfo` - # @return [Google::Apis::SafebrowsingV4::UserInfo] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHitUserInfo] attr_accessor :user_info def initialize(**args) @@ -719,131 +719,8 @@ module Google end end - # The information regarding one or more threats that a client submits when - # checking for matches in threat lists. - class ThreatInfo - include Google::Apis::Core::Hashable - - # The platform types to be checked. - # Corresponds to the JSON property `platformTypes` - # @return [Array] - attr_accessor :platform_types - - # The threat entries to be checked. - # Corresponds to the JSON property `threatEntries` - # @return [Array] - attr_accessor :threat_entries - - # The entry types to be checked. - # Corresponds to the JSON property `threatEntryTypes` - # @return [Array] - attr_accessor :threat_entry_types - - # The threat types to be checked. - # Corresponds to the JSON property `threatTypes` - # @return [Array] - attr_accessor :threat_types - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @platform_types = args[:platform_types] if args.key?(:platform_types) - @threat_entries = args[:threat_entries] if args.key?(:threat_entries) - @threat_entry_types = args[:threat_entry_types] if args.key?(:threat_entry_types) - @threat_types = args[:threat_types] if args.key?(:threat_types) - end - end - - # Describes an individual threat list. A list is defined by three parameters: - # the type of threat posed, the type of platform targeted by the threat, and the - # type of entries in the list. - class ThreatListDescriptor - include Google::Apis::Core::Hashable - - # The platform type targeted by the list's entries. - # Corresponds to the JSON property `platformType` - # @return [String] - attr_accessor :platform_type - - # The entry types contained in the list. - # Corresponds to the JSON property `threatEntryType` - # @return [String] - attr_accessor :threat_entry_type - - # The threat type posed by the list's entries. - # Corresponds to the JSON property `threatType` - # @return [String] - attr_accessor :threat_type - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @platform_type = args[:platform_type] if args.key?(:platform_type) - @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) - @threat_type = args[:threat_type] if args.key?(:threat_type) - end - end - - # A match when checking a threat entry in the Safe Browsing threat lists. - class ThreatMatch - include Google::Apis::Core::Hashable - - # The cache lifetime for the returned match. Clients must not cache this - # response for more than this duration to avoid false positives. - # Corresponds to the JSON property `cacheDuration` - # @return [String] - attr_accessor :cache_duration - - # The platform type matching this threat. - # Corresponds to the JSON property `platformType` - # @return [String] - attr_accessor :platform_type - - # An individual threat; for example, a malicious URL or its hash representation. - # Only one of these fields should be set. - # Corresponds to the JSON property `threat` - # @return [Google::Apis::SafebrowsingV4::ThreatEntry] - attr_accessor :threat - - # The metadata associated with a specific threat entry. The client is expected - # to know the metadata key/value pairs associated with each threat type. - # Corresponds to the JSON property `threatEntryMetadata` - # @return [Google::Apis::SafebrowsingV4::ThreatEntryMetadata] - attr_accessor :threat_entry_metadata - - # The threat entry type matching this threat. - # Corresponds to the JSON property `threatEntryType` - # @return [String] - attr_accessor :threat_entry_type - - # The threat type matching this threat. - # Corresponds to the JSON property `threatType` - # @return [String] - attr_accessor :threat_type - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @cache_duration = args[:cache_duration] if args.key?(:cache_duration) - @platform_type = args[:platform_type] if args.key?(:platform_type) - @threat = args[:threat] if args.key?(:threat) - @threat_entry_metadata = args[:threat_entry_metadata] if args.key?(:threat_entry_metadata) - @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) - @threat_type = args[:threat_type] if args.key?(:threat_type) - end - end - # A single resource related to a threat hit. - class ThreatSource + class GoogleSecuritySafebrowsingV4ThreatHitThreatSource include Google::Apis::Core::Hashable # Referrer of the resource. Only set if the referrer is available. @@ -880,7 +757,7 @@ module Google end # Details about the user that encountered the threat. - class UserInfo + class GoogleSecuritySafebrowsingV4ThreatHitUserInfo include Google::Apis::Core::Hashable # The UN M.49 region code associated with the user's location. @@ -904,6 +781,129 @@ module Google @user_id = args[:user_id] if args.key?(:user_id) end end + + # The information regarding one or more threats that a client submits when + # checking for matches in threat lists. + class GoogleSecuritySafebrowsingV4ThreatInfo + include Google::Apis::Core::Hashable + + # The platform types to be checked. + # Corresponds to the JSON property `platformTypes` + # @return [Array] + attr_accessor :platform_types + + # The threat entries to be checked. + # Corresponds to the JSON property `threatEntries` + # @return [Array] + attr_accessor :threat_entries + + # The entry types to be checked. + # Corresponds to the JSON property `threatEntryTypes` + # @return [Array] + attr_accessor :threat_entry_types + + # The threat types to be checked. + # Corresponds to the JSON property `threatTypes` + # @return [Array] + attr_accessor :threat_types + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @platform_types = args[:platform_types] if args.key?(:platform_types) + @threat_entries = args[:threat_entries] if args.key?(:threat_entries) + @threat_entry_types = args[:threat_entry_types] if args.key?(:threat_entry_types) + @threat_types = args[:threat_types] if args.key?(:threat_types) + end + end + + # Describes an individual threat list. A list is defined by three parameters: + # the type of threat posed, the type of platform targeted by the threat, and the + # type of entries in the list. + class GoogleSecuritySafebrowsingV4ThreatListDescriptor + include Google::Apis::Core::Hashable + + # The platform type targeted by the list's entries. + # Corresponds to the JSON property `platformType` + # @return [String] + attr_accessor :platform_type + + # The entry types contained in the list. + # Corresponds to the JSON property `threatEntryType` + # @return [String] + attr_accessor :threat_entry_type + + # The threat type posed by the list's entries. + # Corresponds to the JSON property `threatType` + # @return [String] + attr_accessor :threat_type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @platform_type = args[:platform_type] if args.key?(:platform_type) + @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) + @threat_type = args[:threat_type] if args.key?(:threat_type) + end + end + + # A match when checking a threat entry in the Safe Browsing threat lists. + class GoogleSecuritySafebrowsingV4ThreatMatch + include Google::Apis::Core::Hashable + + # The cache lifetime for the returned match. Clients must not cache this + # response for more than this duration to avoid false positives. + # Corresponds to the JSON property `cacheDuration` + # @return [String] + attr_accessor :cache_duration + + # The platform type matching this threat. + # Corresponds to the JSON property `platformType` + # @return [String] + attr_accessor :platform_type + + # An individual threat; for example, a malicious URL or its hash representation. + # Only one of these fields should be set. + # Corresponds to the JSON property `threat` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry] + attr_accessor :threat + + # The metadata associated with a specific threat entry. The client is expected + # to know the metadata key/value pairs associated with each threat type. + # Corresponds to the JSON property `threatEntryMetadata` + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntryMetadata] + attr_accessor :threat_entry_metadata + + # The threat entry type matching this threat. + # Corresponds to the JSON property `threatEntryType` + # @return [String] + attr_accessor :threat_entry_type + + # The threat type matching this threat. + # Corresponds to the JSON property `threatType` + # @return [String] + attr_accessor :threat_type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @cache_duration = args[:cache_duration] if args.key?(:cache_duration) + @platform_type = args[:platform_type] if args.key?(:platform_type) + @threat = args[:threat] if args.key?(:threat) + @threat_entry_metadata = args[:threat_entry_metadata] if args.key?(:threat_entry_metadata) + @threat_entry_type = args[:threat_entry_type] if args.key?(:threat_entry_type) + @threat_type = args[:threat_type] if args.key?(:threat_type) + end + end end end end diff --git a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/gem_version.rb b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/gem_version.rb index 856a4dab9..c92b82582 100644 --- a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/gem_version.rb +++ b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201213" + REVISION = "20210105" end end end diff --git a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/representations.rb b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/representations.rb index be5979c5c..33491e90d 100644 --- a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/representations.rb +++ b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/representations.rb @@ -22,170 +22,176 @@ module Google module Apis module SafebrowsingV4 - class Checksum + class GoogleProtobufEmpty class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ClientInfo + class GoogleSecuritySafebrowsingV4Checksum class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class Constraints + class GoogleSecuritySafebrowsingV4ClientInfo class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class Empty + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FetchThreatListUpdatesRequest + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FetchThreatListUpdatesResponse + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FindFullHashesRequest + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FindFullHashesResponse + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponseListUpdateResponse class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FindThreatMatchesRequest + class GoogleSecuritySafebrowsingV4FindFullHashesRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class FindThreatMatchesResponse + class GoogleSecuritySafebrowsingV4FindFullHashesResponse class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ListThreatListsResponse + class GoogleSecuritySafebrowsingV4FindThreatMatchesRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ListUpdateRequest + class GoogleSecuritySafebrowsingV4FindThreatMatchesResponse class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ListUpdateResponse + class GoogleSecuritySafebrowsingV4ListThreatListsResponse class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class MetadataEntry + class GoogleSecuritySafebrowsingV4RawHashes class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class RawHashes + class GoogleSecuritySafebrowsingV4RawIndices class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class RawIndices + class GoogleSecuritySafebrowsingV4RiceDeltaEncoding class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class RiceDeltaEncoding + class GoogleSecuritySafebrowsingV4ThreatEntry class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatEntry + class GoogleSecuritySafebrowsingV4ThreatEntryMetadata class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatEntryMetadata + class GoogleSecuritySafebrowsingV4ThreatEntryMetadataMetadataEntry class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatEntrySet + class GoogleSecuritySafebrowsingV4ThreatEntrySet class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatHit + class GoogleSecuritySafebrowsingV4ThreatHit class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatInfo + class GoogleSecuritySafebrowsingV4ThreatHitThreatSource class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatListDescriptor + class GoogleSecuritySafebrowsingV4ThreatHitUserInfo class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatMatch + class GoogleSecuritySafebrowsingV4ThreatInfo class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class ThreatSource + class GoogleSecuritySafebrowsingV4ThreatListDescriptor class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class UserInfo + class GoogleSecuritySafebrowsingV4ThreatMatch class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end - class Checksum + class GoogleProtobufEmpty + # @private + class Representation < Google::Apis::Core::JsonRepresentation + end + end + + class GoogleSecuritySafebrowsingV4Checksum # @private class Representation < Google::Apis::Core::JsonRepresentation property :sha256, :base64 => true, as: 'sha256' end end - class ClientInfo + class GoogleSecuritySafebrowsingV4ClientInfo # @private class Representation < Google::Apis::Core::JsonRepresentation property :client_id, as: 'clientId' @@ -193,7 +199,29 @@ module Google end end - class Constraints + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :client, as: 'client', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo::Representation + + collection :list_update_requests, as: 'listUpdateRequests', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequest, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequest::Representation + + end + end + + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :constraints, as: 'constraints', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints::Representation + + property :platform_type, as: 'platformType' + property :state, :base64 => true, as: 'state' + property :threat_entry_type, as: 'threatEntryType' + property :threat_type, as: 'threatType' + end + end + + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequestListUpdateRequestConstraints # @private class Representation < Google::Apis::Core::JsonRepresentation property :device_location, as: 'deviceLocation' @@ -205,102 +233,25 @@ module Google end end - class Empty + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse # @private class Representation < Google::Apis::Core::JsonRepresentation - end - end - - class FetchThreatListUpdatesRequest - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :client, as: 'client', class: Google::Apis::SafebrowsingV4::ClientInfo, decorator: Google::Apis::SafebrowsingV4::ClientInfo::Representation - - collection :list_update_requests, as: 'listUpdateRequests', class: Google::Apis::SafebrowsingV4::ListUpdateRequest, decorator: Google::Apis::SafebrowsingV4::ListUpdateRequest::Representation - - end - end - - class FetchThreatListUpdatesResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :list_update_responses, as: 'listUpdateResponses', class: Google::Apis::SafebrowsingV4::ListUpdateResponse, decorator: Google::Apis::SafebrowsingV4::ListUpdateResponse::Representation + collection :list_update_responses, as: 'listUpdateResponses', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponseListUpdateResponse, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponseListUpdateResponse::Representation property :minimum_wait_duration, as: 'minimumWaitDuration' end end - class FindFullHashesRequest + class GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponseListUpdateResponse # @private class Representation < Google::Apis::Core::JsonRepresentation - property :api_client, as: 'apiClient', class: Google::Apis::SafebrowsingV4::ClientInfo, decorator: Google::Apis::SafebrowsingV4::ClientInfo::Representation + collection :additions, as: 'additions', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntrySet, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntrySet::Representation - property :client, as: 'client', class: Google::Apis::SafebrowsingV4::ClientInfo, decorator: Google::Apis::SafebrowsingV4::ClientInfo::Representation - - collection :client_states, as: 'clientStates' - property :threat_info, as: 'threatInfo', class: Google::Apis::SafebrowsingV4::ThreatInfo, decorator: Google::Apis::SafebrowsingV4::ThreatInfo::Representation - - end - end - - class FindFullHashesResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :matches, as: 'matches', class: Google::Apis::SafebrowsingV4::ThreatMatch, decorator: Google::Apis::SafebrowsingV4::ThreatMatch::Representation - - property :minimum_wait_duration, as: 'minimumWaitDuration' - property :negative_cache_duration, as: 'negativeCacheDuration' - end - end - - class FindThreatMatchesRequest - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :client, as: 'client', class: Google::Apis::SafebrowsingV4::ClientInfo, decorator: Google::Apis::SafebrowsingV4::ClientInfo::Representation - - property :threat_info, as: 'threatInfo', class: Google::Apis::SafebrowsingV4::ThreatInfo, decorator: Google::Apis::SafebrowsingV4::ThreatInfo::Representation - - end - end - - class FindThreatMatchesResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :matches, as: 'matches', class: Google::Apis::SafebrowsingV4::ThreatMatch, decorator: Google::Apis::SafebrowsingV4::ThreatMatch::Representation - - end - end - - class ListThreatListsResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :threat_lists, as: 'threatLists', class: Google::Apis::SafebrowsingV4::ThreatListDescriptor, decorator: Google::Apis::SafebrowsingV4::ThreatListDescriptor::Representation - - end - end - - class ListUpdateRequest - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :constraints, as: 'constraints', class: Google::Apis::SafebrowsingV4::Constraints, decorator: Google::Apis::SafebrowsingV4::Constraints::Representation - - property :platform_type, as: 'platformType' - property :state, :base64 => true, as: 'state' - property :threat_entry_type, as: 'threatEntryType' - property :threat_type, as: 'threatType' - end - end - - class ListUpdateResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :additions, as: 'additions', class: Google::Apis::SafebrowsingV4::ThreatEntrySet, decorator: Google::Apis::SafebrowsingV4::ThreatEntrySet::Representation - - property :checksum, as: 'checksum', class: Google::Apis::SafebrowsingV4::Checksum, decorator: Google::Apis::SafebrowsingV4::Checksum::Representation + property :checksum, as: 'checksum', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4Checksum, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4Checksum::Representation property :new_client_state, :base64 => true, as: 'newClientState' property :platform_type, as: 'platformType' - collection :removals, as: 'removals', class: Google::Apis::SafebrowsingV4::ThreatEntrySet, decorator: Google::Apis::SafebrowsingV4::ThreatEntrySet::Representation + collection :removals, as: 'removals', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntrySet, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntrySet::Representation property :response_type, as: 'responseType' property :threat_entry_type, as: 'threatEntryType' @@ -308,15 +259,56 @@ module Google end end - class MetadataEntry + class GoogleSecuritySafebrowsingV4FindFullHashesRequest # @private class Representation < Google::Apis::Core::JsonRepresentation - property :key, :base64 => true, as: 'key' - property :value, :base64 => true, as: 'value' + property :api_client, as: 'apiClient', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo::Representation + + property :client, as: 'client', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo::Representation + + collection :client_states, as: 'clientStates' + property :threat_info, as: 'threatInfo', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo::Representation + end end - class RawHashes + class GoogleSecuritySafebrowsingV4FindFullHashesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :matches, as: 'matches', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatMatch, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatMatch::Representation + + property :minimum_wait_duration, as: 'minimumWaitDuration' + property :negative_cache_duration, as: 'negativeCacheDuration' + end + end + + class GoogleSecuritySafebrowsingV4FindThreatMatchesRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :client, as: 'client', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo::Representation + + property :threat_info, as: 'threatInfo', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatInfo::Representation + + end + end + + class GoogleSecuritySafebrowsingV4FindThreatMatchesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :matches, as: 'matches', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatMatch, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatMatch::Representation + + end + end + + class GoogleSecuritySafebrowsingV4ListThreatListsResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :threat_lists, as: 'threatLists', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatListDescriptor, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatListDescriptor::Representation + + end + end + + class GoogleSecuritySafebrowsingV4RawHashes # @private class Representation < Google::Apis::Core::JsonRepresentation property :prefix_size, as: 'prefixSize' @@ -324,14 +316,14 @@ module Google end end - class RawIndices + class GoogleSecuritySafebrowsingV4RawIndices # @private class Representation < Google::Apis::Core::JsonRepresentation collection :indices, as: 'indices' end end - class RiceDeltaEncoding + class GoogleSecuritySafebrowsingV4RiceDeltaEncoding # @private class Representation < Google::Apis::Core::JsonRepresentation property :encoded_data, :base64 => true, as: 'encodedData' @@ -341,7 +333,7 @@ module Google end end - class ThreatEntry + class GoogleSecuritySafebrowsingV4ThreatEntry # @private class Representation < Google::Apis::Core::JsonRepresentation property :digest, :base64 => true, as: 'digest' @@ -350,80 +342,54 @@ module Google end end - class ThreatEntryMetadata + class GoogleSecuritySafebrowsingV4ThreatEntryMetadata # @private class Representation < Google::Apis::Core::JsonRepresentation - collection :entries, as: 'entries', class: Google::Apis::SafebrowsingV4::MetadataEntry, decorator: Google::Apis::SafebrowsingV4::MetadataEntry::Representation + collection :entries, as: 'entries', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntryMetadataMetadataEntry, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntryMetadataMetadataEntry::Representation end end - class ThreatEntrySet + class GoogleSecuritySafebrowsingV4ThreatEntryMetadataMetadataEntry + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :key, :base64 => true, as: 'key' + property :value, :base64 => true, as: 'value' + end + end + + class GoogleSecuritySafebrowsingV4ThreatEntrySet # @private class Representation < Google::Apis::Core::JsonRepresentation property :compression_type, as: 'compressionType' - property :raw_hashes, as: 'rawHashes', class: Google::Apis::SafebrowsingV4::RawHashes, decorator: Google::Apis::SafebrowsingV4::RawHashes::Representation + property :raw_hashes, as: 'rawHashes', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawHashes, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawHashes::Representation - property :raw_indices, as: 'rawIndices', class: Google::Apis::SafebrowsingV4::RawIndices, decorator: Google::Apis::SafebrowsingV4::RawIndices::Representation + property :raw_indices, as: 'rawIndices', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawIndices, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RawIndices::Representation - property :rice_hashes, as: 'riceHashes', class: Google::Apis::SafebrowsingV4::RiceDeltaEncoding, decorator: Google::Apis::SafebrowsingV4::RiceDeltaEncoding::Representation + property :rice_hashes, as: 'riceHashes', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding::Representation - property :rice_indices, as: 'riceIndices', class: Google::Apis::SafebrowsingV4::RiceDeltaEncoding, decorator: Google::Apis::SafebrowsingV4::RiceDeltaEncoding::Representation + property :rice_indices, as: 'riceIndices', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4RiceDeltaEncoding::Representation end end - class ThreatHit + class GoogleSecuritySafebrowsingV4ThreatHit # @private class Representation < Google::Apis::Core::JsonRepresentation - property :client_info, as: 'clientInfo', class: Google::Apis::SafebrowsingV4::ClientInfo, decorator: Google::Apis::SafebrowsingV4::ClientInfo::Representation + property :client_info, as: 'clientInfo', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ClientInfo::Representation - property :entry, as: 'entry', class: Google::Apis::SafebrowsingV4::ThreatEntry, decorator: Google::Apis::SafebrowsingV4::ThreatEntry::Representation + property :entry, as: 'entry', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry::Representation property :platform_type, as: 'platformType' - collection :resources, as: 'resources', class: Google::Apis::SafebrowsingV4::ThreatSource, decorator: Google::Apis::SafebrowsingV4::ThreatSource::Representation + collection :resources, as: 'resources', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHitThreatSource, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHitThreatSource::Representation property :threat_type, as: 'threatType' - property :user_info, as: 'userInfo', class: Google::Apis::SafebrowsingV4::UserInfo, decorator: Google::Apis::SafebrowsingV4::UserInfo::Representation + property :user_info, as: 'userInfo', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHitUserInfo, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHitUserInfo::Representation end end - class ThreatInfo - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :platform_types, as: 'platformTypes' - collection :threat_entries, as: 'threatEntries', class: Google::Apis::SafebrowsingV4::ThreatEntry, decorator: Google::Apis::SafebrowsingV4::ThreatEntry::Representation - - collection :threat_entry_types, as: 'threatEntryTypes' - collection :threat_types, as: 'threatTypes' - end - end - - class ThreatListDescriptor - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :platform_type, as: 'platformType' - property :threat_entry_type, as: 'threatEntryType' - property :threat_type, as: 'threatType' - end - end - - class ThreatMatch - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :cache_duration, as: 'cacheDuration' - property :platform_type, as: 'platformType' - property :threat, as: 'threat', class: Google::Apis::SafebrowsingV4::ThreatEntry, decorator: Google::Apis::SafebrowsingV4::ThreatEntry::Representation - - property :threat_entry_metadata, as: 'threatEntryMetadata', class: Google::Apis::SafebrowsingV4::ThreatEntryMetadata, decorator: Google::Apis::SafebrowsingV4::ThreatEntryMetadata::Representation - - property :threat_entry_type, as: 'threatEntryType' - property :threat_type, as: 'threatType' - end - end - - class ThreatSource + class GoogleSecuritySafebrowsingV4ThreatHitThreatSource # @private class Representation < Google::Apis::Core::JsonRepresentation property :referrer, as: 'referrer' @@ -433,13 +399,47 @@ module Google end end - class UserInfo + class GoogleSecuritySafebrowsingV4ThreatHitUserInfo # @private class Representation < Google::Apis::Core::JsonRepresentation property :region_code, as: 'regionCode' property :user_id, :base64 => true, as: 'userId' end end + + class GoogleSecuritySafebrowsingV4ThreatInfo + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :platform_types, as: 'platformTypes' + collection :threat_entries, as: 'threatEntries', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry::Representation + + collection :threat_entry_types, as: 'threatEntryTypes' + collection :threat_types, as: 'threatTypes' + end + end + + class GoogleSecuritySafebrowsingV4ThreatListDescriptor + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :platform_type, as: 'platformType' + property :threat_entry_type, as: 'threatEntryType' + property :threat_type, as: 'threatType' + end + end + + class GoogleSecuritySafebrowsingV4ThreatMatch + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :cache_duration, as: 'cacheDuration' + property :platform_type, as: 'platformType' + property :threat, as: 'threat', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntry::Representation + + property :threat_entry_metadata, as: 'threatEntryMetadata', class: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntryMetadata, decorator: Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatEntryMetadata::Representation + + property :threat_entry_type, as: 'threatEntryType' + property :threat_type, as: 'threatType' + end + end end end end diff --git a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/service.rb b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/service.rb index 1c27f8501..c52e23214 100644 --- a/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/service.rb +++ b/generated/google-apis-safebrowsing_v4/lib/google/apis/safebrowsing_v4/service.rb @@ -70,18 +70,18 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::FindFullHashesResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::FindFullHashesResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required def get_encoded_full_hash(encoded_request, client_id: nil, client_version: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v4/encodedFullHashes/{encodedRequest}', options) - command.response_representation = Google::Apis::SafebrowsingV4::FindFullHashesResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::FindFullHashesResponse + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse command.params['encodedRequest'] = encoded_request unless encoded_request.nil? command.query['clientId'] = client_id unless client_id.nil? command.query['clientVersion'] = client_version unless client_version.nil? @@ -107,18 +107,18 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required def get_encoded_update(encoded_request, client_id: nil, client_version: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v4/encodedUpdates/{encodedRequest}', options) - command.response_representation = Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse command.params['encodedRequest'] = encoded_request unless encoded_request.nil? command.query['clientId'] = client_id unless client_id.nil? command.query['clientVersion'] = client_version unless client_version.nil? @@ -128,7 +128,7 @@ module Google end # Finds the full hashes that match the requested hash prefixes. - # @param [Google::Apis::SafebrowsingV4::FindFullHashesRequest] find_full_hashes_request_object + # @param [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesRequest] google_security_safebrowsing_v4_find_full_hashes_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -138,20 +138,20 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::FindFullHashesResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::FindFullHashesResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def find_full_hashes(find_full_hashes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + def find_full_hashes(google_security_safebrowsing_v4_find_full_hashes_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v4/fullHashes:find', options) - command.request_representation = Google::Apis::SafebrowsingV4::FindFullHashesRequest::Representation - command.request_object = find_full_hashes_request_object - command.response_representation = Google::Apis::SafebrowsingV4::FindFullHashesResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::FindFullHashesResponse + command.request_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesRequest::Representation + command.request_object = google_security_safebrowsing_v4_find_full_hashes_request_object + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindFullHashesResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -159,7 +159,7 @@ module Google # Reports a Safe Browsing threat list hit to Google. Only projects with # TRUSTED_REPORTER visibility can use this method. - # @param [Google::Apis::SafebrowsingV4::ThreatHit] threat_hit_object + # @param [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHit] google_security_safebrowsing_v4_threat_hit_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -169,20 +169,20 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::Empty] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleProtobufEmpty] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::Empty] + # @return [Google::Apis::SafebrowsingV4::GoogleProtobufEmpty] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_threat_hit(threat_hit_object = nil, fields: nil, quota_user: nil, options: nil, &block) + def create_threat_hit(google_security_safebrowsing_v4_threat_hit_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v4/threatHits', options) - command.request_representation = Google::Apis::SafebrowsingV4::ThreatHit::Representation - command.request_object = threat_hit_object - command.response_representation = Google::Apis::SafebrowsingV4::Empty::Representation - command.response_class = Google::Apis::SafebrowsingV4::Empty + command.request_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ThreatHit::Representation + command.request_object = google_security_safebrowsing_v4_threat_hit_object + command.response_representation = Google::Apis::SafebrowsingV4::GoogleProtobufEmpty::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleProtobufEmpty command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -190,7 +190,7 @@ module Google # Fetches the most recent threat list updates. A client can request updates for # multiple lists at once. - # @param [Google::Apis::SafebrowsingV4::FetchThreatListUpdatesRequest] fetch_threat_list_updates_request_object + # @param [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest] google_security_safebrowsing_v4_fetch_threat_list_updates_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -200,20 +200,20 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def fetch_threat_list_updates(fetch_threat_list_updates_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + def fetch_threat_list_updates(google_security_safebrowsing_v4_fetch_threat_list_updates_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v4/threatListUpdates:fetch', options) - command.request_representation = Google::Apis::SafebrowsingV4::FetchThreatListUpdatesRequest::Representation - command.request_object = fetch_threat_list_updates_request_object - command.response_representation = Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::FetchThreatListUpdatesResponse + command.request_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest::Representation + command.request_object = google_security_safebrowsing_v4_fetch_threat_list_updates_request_object + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -229,25 +229,25 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::ListThreatListsResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ListThreatListsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::ListThreatListsResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ListThreatListsResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required def list_threat_lists(fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v4/threatLists', options) - command.response_representation = Google::Apis::SafebrowsingV4::ListThreatListsResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::ListThreatListsResponse + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ListThreatListsResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4ListThreatListsResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end # Finds the threat entries that match the Safe Browsing lists. - # @param [Google::Apis::SafebrowsingV4::FindThreatMatchesRequest] find_threat_matches_request_object + # @param [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesRequest] google_security_safebrowsing_v4_find_threat_matches_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -257,20 +257,20 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SafebrowsingV4::FindThreatMatchesResponse] parsed result object + # @yieldparam result [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SafebrowsingV4::FindThreatMatchesResponse] + # @return [Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def find_threat_matches(find_threat_matches_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + def find_threat_matches(google_security_safebrowsing_v4_find_threat_matches_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v4/threatMatches:find', options) - command.request_representation = Google::Apis::SafebrowsingV4::FindThreatMatchesRequest::Representation - command.request_object = find_threat_matches_request_object - command.response_representation = Google::Apis::SafebrowsingV4::FindThreatMatchesResponse::Representation - command.response_class = Google::Apis::SafebrowsingV4::FindThreatMatchesResponse + command.request_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesRequest::Representation + command.request_object = google_security_safebrowsing_v4_find_threat_matches_request_object + command.response_representation = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesResponse::Representation + command.response_class = Google::Apis::SafebrowsingV4::GoogleSecuritySafebrowsingV4FindThreatMatchesResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) diff --git a/generated/google-apis-sasportal_v1alpha1/CHANGELOG.md b/generated/google-apis-sasportal_v1alpha1/CHANGELOG.md index fbefab504..14192c1ca 100644 --- a/generated/google-apis-sasportal_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-sasportal_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sasportal_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201019 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sasportal_v1alpha1/OVERVIEW.md b/generated/google-apis-sasportal_v1alpha1/OVERVIEW.md index 1c0691bfd..0fd0e25cd 100644 --- a/generated/google-apis-sasportal_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-sasportal_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the SAS Portal API +# Simple REST client for version V1alpha1 of the SAS Portal API This is a simple client library for version V1alpha1 of the SAS Portal API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the SAS Portal API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sasportal service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sasportal service in particular.) For reference information on specific calls in the SAS Portal API, see the {Google::Apis::SasportalV1alpha1::SasportalService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sasportal_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sasportal_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/spectrum-access-system/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sasportal_v1alpha1/google-apis-sasportal_v1alpha1.gemspec b/generated/google-apis-sasportal_v1alpha1/google-apis-sasportal_v1alpha1.gemspec index 7ecde3923..c2304a9d2 100644 --- a/generated/google-apis-sasportal_v1alpha1/google-apis-sasportal_v1alpha1.gemspec +++ b/generated/google-apis-sasportal_v1alpha1/google-apis-sasportal_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SasportalV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for SAS Portal API V1alpha1" + gem.summary = "Simple REST client for SAS Portal API V1alpha1" gem.description = - "This is the legacy REST client for SAS Portal API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for SAS Portal API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sasportal_v1alpha1/lib/google/apis/sasportal_v1alpha1/gem_version.rb b/generated/google-apis-sasportal_v1alpha1/lib/google/apis/sasportal_v1alpha1/gem_version.rb index 083714dcf..8fc31f5c2 100644 --- a/generated/google-apis-sasportal_v1alpha1/lib/google/apis/sasportal_v1alpha1/gem_version.rb +++ b/generated/google-apis-sasportal_v1alpha1/lib/google/apis/sasportal_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201019" diff --git a/generated/google-apis-script_v1/CHANGELOG.md b/generated/google-apis-script_v1/CHANGELOG.md index e0a51897e..3dfaf3a6b 100644 --- a/generated/google-apis-script_v1/CHANGELOG.md +++ b/generated/google-apis-script_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-script_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200811 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-script_v1/OVERVIEW.md b/generated/google-apis-script_v1/OVERVIEW.md index 5a85355fb..192e89c1a 100644 --- a/generated/google-apis-script_v1/OVERVIEW.md +++ b/generated/google-apis-script_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Apps Script API +# Simple REST client for version V1 of the Apps Script API This is a simple client library for version V1 of the Apps Script API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Apps Script API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Script service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Script service in particular.) For reference information on specific calls in the Apps Script API, see the {Google::Apis::ScriptV1::ScriptService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-script_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-script_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/apps-script/api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-script_v1/google-apis-script_v1.gemspec b/generated/google-apis-script_v1/google-apis-script_v1.gemspec index 42e7ef842..6ce20d1c7 100644 --- a/generated/google-apis-script_v1/google-apis-script_v1.gemspec +++ b/generated/google-apis-script_v1/google-apis-script_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ScriptV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Apps Script API V1" + gem.summary = "Simple REST client for Apps Script API V1" gem.description = - "This is the legacy REST client for Apps Script API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Apps Script API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-script_v1/lib/google/apis/script_v1/gem_version.rb b/generated/google-apis-script_v1/lib/google/apis/script_v1/gem_version.rb index a8eb3fc33..2dd24746c 100644 --- a/generated/google-apis-script_v1/lib/google/apis/script_v1/gem_version.rb +++ b/generated/google-apis-script_v1/lib/google/apis/script_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200811" diff --git a/generated/google-apis-searchconsole_v1/CHANGELOG.md b/generated/google-apis-searchconsole_v1/CHANGELOG.md index 4c6549e4f..59d49d3ad 100644 --- a/generated/google-apis-searchconsole_v1/CHANGELOG.md +++ b/generated/google-apis-searchconsole_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-searchconsole_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201209 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-searchconsole_v1/OVERVIEW.md b/generated/google-apis-searchconsole_v1/OVERVIEW.md index f3ed2e4c3..fd0928102 100644 --- a/generated/google-apis-searchconsole_v1/OVERVIEW.md +++ b/generated/google-apis-searchconsole_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Search Console API +# Simple REST client for version V1 of the Google Search Console API This is a simple client library for version V1 of the Google Search Console API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Search Console API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Searchconsole service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Searchconsole service in particular.) For reference information on specific calls in the Google Search Console API, see the {Google::Apis::SearchconsoleV1::SearchConsoleService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-searchconsole_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-searchconsole_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/webmaster-tools/search-console-api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-searchconsole_v1/google-apis-searchconsole_v1.gemspec b/generated/google-apis-searchconsole_v1/google-apis-searchconsole_v1.gemspec index e3ac2b841..c7b634473 100644 --- a/generated/google-apis-searchconsole_v1/google-apis-searchconsole_v1.gemspec +++ b/generated/google-apis-searchconsole_v1/google-apis-searchconsole_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SearchconsoleV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Search Console API V1" + gem.summary = "Simple REST client for Google Search Console API V1" gem.description = - "This is the legacy REST client for Google Search Console API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Search Console API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-searchconsole_v1/lib/google/apis/searchconsole_v1/gem_version.rb b/generated/google-apis-searchconsole_v1/lib/google/apis/searchconsole_v1/gem_version.rb index f689960e0..f64562ade 100644 --- a/generated/google-apis-searchconsole_v1/lib/google/apis/searchconsole_v1/gem_version.rb +++ b/generated/google-apis-searchconsole_v1/lib/google/apis/searchconsole_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201209" diff --git a/generated/google-apis-secretmanager_v1/CHANGELOG.md b/generated/google-apis-secretmanager_v1/CHANGELOG.md index c30fa641d..71ed637cb 100644 --- a/generated/google-apis-secretmanager_v1/CHANGELOG.md +++ b/generated/google-apis-secretmanager_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-secretmanager_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201106 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-secretmanager_v1/OVERVIEW.md b/generated/google-apis-secretmanager_v1/OVERVIEW.md index 920a0d0e5..aec540a7b 100644 --- a/generated/google-apis-secretmanager_v1/OVERVIEW.md +++ b/generated/google-apis-secretmanager_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Secret Manager API +# Simple REST client for version V1 of the Secret Manager API This is a simple client library for version V1 of the Secret Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Secret Manager API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Secretmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Secretmanager service in particular.) For reference information on specific calls in the Secret Manager API, see the {Google::Apis::SecretmanagerV1::SecretManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-secretmanager_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-secretmanager_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/secret-manager/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-secretmanager_v1/google-apis-secretmanager_v1.gemspec b/generated/google-apis-secretmanager_v1/google-apis-secretmanager_v1.gemspec index 9e65483c1..71ba3f7a6 100644 --- a/generated/google-apis-secretmanager_v1/google-apis-secretmanager_v1.gemspec +++ b/generated/google-apis-secretmanager_v1/google-apis-secretmanager_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SecretmanagerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Secret Manager API V1" + gem.summary = "Simple REST client for Secret Manager API V1" gem.description = - "This is the legacy REST client for Secret Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Secret Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-secretmanager_v1/lib/google/apis/secretmanager_v1/gem_version.rb b/generated/google-apis-secretmanager_v1/lib/google/apis/secretmanager_v1/gem_version.rb index 188788bbf..c7a517f7b 100644 --- a/generated/google-apis-secretmanager_v1/lib/google/apis/secretmanager_v1/gem_version.rb +++ b/generated/google-apis-secretmanager_v1/lib/google/apis/secretmanager_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201106" diff --git a/generated/google-apis-secretmanager_v1beta1/CHANGELOG.md b/generated/google-apis-secretmanager_v1beta1/CHANGELOG.md index dc38b155b..349aa48d8 100644 --- a/generated/google-apis-secretmanager_v1beta1/CHANGELOG.md +++ b/generated/google-apis-secretmanager_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-secretmanager_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201106 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-secretmanager_v1beta1/OVERVIEW.md b/generated/google-apis-secretmanager_v1beta1/OVERVIEW.md index a651ad8c2..987633ecf 100644 --- a/generated/google-apis-secretmanager_v1beta1/OVERVIEW.md +++ b/generated/google-apis-secretmanager_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Secret Manager API +# Simple REST client for version V1beta1 of the Secret Manager API This is a simple client library for version V1beta1 of the Secret Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Secret Manager API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Secretmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Secretmanager service in particular.) For reference information on specific calls in the Secret Manager API, see the {Google::Apis::SecretmanagerV1beta1::SecretManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-secretmanager_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-secretmanager_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/secret-manager/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-secretmanager_v1beta1/google-apis-secretmanager_v1beta1.gemspec b/generated/google-apis-secretmanager_v1beta1/google-apis-secretmanager_v1beta1.gemspec index e2c0d9b7c..8849f36a9 100644 --- a/generated/google-apis-secretmanager_v1beta1/google-apis-secretmanager_v1beta1.gemspec +++ b/generated/google-apis-secretmanager_v1beta1/google-apis-secretmanager_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SecretmanagerV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Secret Manager API V1beta1" + gem.summary = "Simple REST client for Secret Manager API V1beta1" gem.description = - "This is the legacy REST client for Secret Manager API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Secret Manager API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-secretmanager_v1beta1/lib/google/apis/secretmanager_v1beta1/gem_version.rb b/generated/google-apis-secretmanager_v1beta1/lib/google/apis/secretmanager_v1beta1/gem_version.rb index 2fe0de6cf..35cf86a02 100644 --- a/generated/google-apis-secretmanager_v1beta1/lib/google/apis/secretmanager_v1beta1/gem_version.rb +++ b/generated/google-apis-secretmanager_v1beta1/lib/google/apis/secretmanager_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201106" diff --git a/generated/google-apis-securitycenter_v1/OVERVIEW.md b/generated/google-apis-securitycenter_v1/OVERVIEW.md index 2b7d64df2..581e08467 100644 --- a/generated/google-apis-securitycenter_v1/OVERVIEW.md +++ b/generated/google-apis-securitycenter_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Security Command Center API +# Simple REST client for version V1 of the Security Command Center API This is a simple client library for version V1 of the Security Command Center API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Security Command Center AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Securitycenter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Securitycenter service in particular.) For reference information on specific calls in the Security Command Center API, see the {Google::Apis::SecuritycenterV1::SecurityCommandCenterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-securitycenter_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-securitycenter_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-securitycenter_v1/google-apis-securitycenter_v1.gemspec b/generated/google-apis-securitycenter_v1/google-apis-securitycenter_v1.gemspec index 01d1082b4..1f00aa672 100644 --- a/generated/google-apis-securitycenter_v1/google-apis-securitycenter_v1.gemspec +++ b/generated/google-apis-securitycenter_v1/google-apis-securitycenter_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SecuritycenterV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Security Command Center API V1" + gem.summary = "Simple REST client for Security Command Center API V1" gem.description = - "This is the legacy REST client for Security Command Center API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Security Command Center API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-securitycenter_v1beta1/OVERVIEW.md b/generated/google-apis-securitycenter_v1beta1/OVERVIEW.md index d8c456419..737108a16 100644 --- a/generated/google-apis-securitycenter_v1beta1/OVERVIEW.md +++ b/generated/google-apis-securitycenter_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Security Command Center API +# Simple REST client for version V1beta1 of the Security Command Center API This is a simple client library for version V1beta1 of the Security Command Center API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Security Command Cent * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Securitycenter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Securitycenter service in particular.) For reference information on specific calls in the Security Command Center API, see the {Google::Apis::SecuritycenterV1beta1::SecurityCommandCenterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-securitycenter_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-securitycenter_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-securitycenter_v1beta1/google-apis-securitycenter_v1beta1.gemspec b/generated/google-apis-securitycenter_v1beta1/google-apis-securitycenter_v1beta1.gemspec index ef99489d4..caf19c26d 100644 --- a/generated/google-apis-securitycenter_v1beta1/google-apis-securitycenter_v1beta1.gemspec +++ b/generated/google-apis-securitycenter_v1beta1/google-apis-securitycenter_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SecuritycenterV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Security Command Center API V1beta1" + gem.summary = "Simple REST client for Security Command Center API V1beta1" gem.description = - "This is the legacy REST client for Security Command Center API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Security Command Center API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-securitycenter_v1beta2/OVERVIEW.md b/generated/google-apis-securitycenter_v1beta2/OVERVIEW.md index 36da4ec34..4fa631dc3 100644 --- a/generated/google-apis-securitycenter_v1beta2/OVERVIEW.md +++ b/generated/google-apis-securitycenter_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Security Command Center API +# Simple REST client for version V1beta2 of the Security Command Center API This is a simple client library for version V1beta2 of the Security Command Center API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Security Command Cent * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Securitycenter service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Securitycenter service in particular.) For reference information on specific calls in the Security Command Center API, see the {Google::Apis::SecuritycenterV1beta2::SecurityCommandCenterService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-securitycenter_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-securitycenter_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-securitycenter_v1beta2/google-apis-securitycenter_v1beta2.gemspec b/generated/google-apis-securitycenter_v1beta2/google-apis-securitycenter_v1beta2.gemspec index 6fc9482b8..5d726edef 100644 --- a/generated/google-apis-securitycenter_v1beta2/google-apis-securitycenter_v1beta2.gemspec +++ b/generated/google-apis-securitycenter_v1beta2/google-apis-securitycenter_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SecuritycenterV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Security Command Center API V1beta2" + gem.summary = "Simple REST client for Security Command Center API V1beta2" gem.description = - "This is the legacy REST client for Security Command Center API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Security Command Center API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceconsumermanagement_v1/CHANGELOG.md b/generated/google-apis-serviceconsumermanagement_v1/CHANGELOG.md index c79201b2b..3fc34d17e 100644 --- a/generated/google-apis-serviceconsumermanagement_v1/CHANGELOG.md +++ b/generated/google-apis-serviceconsumermanagement_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-serviceconsumermanagement_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-serviceconsumermanagement_v1/OVERVIEW.md b/generated/google-apis-serviceconsumermanagement_v1/OVERVIEW.md index 17272d134..7322e208c 100644 --- a/generated/google-apis-serviceconsumermanagement_v1/OVERVIEW.md +++ b/generated/google-apis-serviceconsumermanagement_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Consumer Management API +# Simple REST client for version V1 of the Service Consumer Management API This is a simple client library for version V1 of the Service Consumer Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Consumer Managemen * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Serviceconsumermanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Serviceconsumermanagement service in particular.) For reference information on specific calls in the Service Consumer Management API, see the {Google::Apis::ServiceconsumermanagementV1::ServiceConsumerManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-serviceconsumermanagement_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-serviceconsumermanagement_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-consumer-management/docs/overview) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-serviceconsumermanagement_v1/google-apis-serviceconsumermanagement_v1.gemspec b/generated/google-apis-serviceconsumermanagement_v1/google-apis-serviceconsumermanagement_v1.gemspec index 035ac6b31..37fbf5665 100644 --- a/generated/google-apis-serviceconsumermanagement_v1/google-apis-serviceconsumermanagement_v1.gemspec +++ b/generated/google-apis-serviceconsumermanagement_v1/google-apis-serviceconsumermanagement_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServiceconsumermanagementV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Consumer Management API V1" + gem.summary = "Simple REST client for Service Consumer Management API V1" gem.description = - "This is the legacy REST client for Service Consumer Management API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Consumer Management API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceconsumermanagement_v1/lib/google/apis/serviceconsumermanagement_v1/gem_version.rb b/generated/google-apis-serviceconsumermanagement_v1/lib/google/apis/serviceconsumermanagement_v1/gem_version.rb index a92c76a34..5ae9a16d8 100644 --- a/generated/google-apis-serviceconsumermanagement_v1/lib/google/apis/serviceconsumermanagement_v1/gem_version.rb +++ b/generated/google-apis-serviceconsumermanagement_v1/lib/google/apis/serviceconsumermanagement_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-serviceconsumermanagement_v1beta1/CHANGELOG.md b/generated/google-apis-serviceconsumermanagement_v1beta1/CHANGELOG.md index 1db480fe0..dcfe96fe5 100644 --- a/generated/google-apis-serviceconsumermanagement_v1beta1/CHANGELOG.md +++ b/generated/google-apis-serviceconsumermanagement_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-serviceconsumermanagement_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-serviceconsumermanagement_v1beta1/OVERVIEW.md b/generated/google-apis-serviceconsumermanagement_v1beta1/OVERVIEW.md index c7e70ec53..5da51c493 100644 --- a/generated/google-apis-serviceconsumermanagement_v1beta1/OVERVIEW.md +++ b/generated/google-apis-serviceconsumermanagement_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Service Consumer Management API +# Simple REST client for version V1beta1 of the Service Consumer Management API This is a simple client library for version V1beta1 of the Service Consumer Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Service Consumer Mana * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Serviceconsumermanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Serviceconsumermanagement service in particular.) For reference information on specific calls in the Service Consumer Management API, see the {Google::Apis::ServiceconsumermanagementV1beta1::ServiceConsumerManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-serviceconsumermanagement_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-serviceconsumermanagement_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-consumer-management/docs/overview) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-serviceconsumermanagement_v1beta1/google-apis-serviceconsumermanagement_v1beta1.gemspec b/generated/google-apis-serviceconsumermanagement_v1beta1/google-apis-serviceconsumermanagement_v1beta1.gemspec index bc9cb1453..3cfdcc2ea 100644 --- a/generated/google-apis-serviceconsumermanagement_v1beta1/google-apis-serviceconsumermanagement_v1beta1.gemspec +++ b/generated/google-apis-serviceconsumermanagement_v1beta1/google-apis-serviceconsumermanagement_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServiceconsumermanagementV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Consumer Management API V1beta1" + gem.summary = "Simple REST client for Service Consumer Management API V1beta1" gem.description = - "This is the legacy REST client for Service Consumer Management API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Consumer Management API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceconsumermanagement_v1beta1/lib/google/apis/serviceconsumermanagement_v1beta1/gem_version.rb b/generated/google-apis-serviceconsumermanagement_v1beta1/lib/google/apis/serviceconsumermanagement_v1beta1/gem_version.rb index 59a2d38a2..c46827e58 100644 --- a/generated/google-apis-serviceconsumermanagement_v1beta1/lib/google/apis/serviceconsumermanagement_v1beta1/gem_version.rb +++ b/generated/google-apis-serviceconsumermanagement_v1beta1/lib/google/apis/serviceconsumermanagement_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-servicecontrol_v1/CHANGELOG.md b/generated/google-apis-servicecontrol_v1/CHANGELOG.md index cb2c6b3a5..3471a5065 100644 --- a/generated/google-apis-servicecontrol_v1/CHANGELOG.md +++ b/generated/google-apis-servicecontrol_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-servicecontrol_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-servicecontrol_v1/OVERVIEW.md b/generated/google-apis-servicecontrol_v1/OVERVIEW.md index af6d6297b..cdaadcaa4 100644 --- a/generated/google-apis-servicecontrol_v1/OVERVIEW.md +++ b/generated/google-apis-servicecontrol_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Control API +# Simple REST client for version V1 of the Service Control API This is a simple client library for version V1 of the Service Control API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Control API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicecontrol service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicecontrol service in particular.) For reference information on specific calls in the Service Control API, see the {Google::Apis::ServicecontrolV1::ServiceControlService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicecontrol_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicecontrol_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-control/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicecontrol_v1/google-apis-servicecontrol_v1.gemspec b/generated/google-apis-servicecontrol_v1/google-apis-servicecontrol_v1.gemspec index 26208b153..5d1f3db89 100644 --- a/generated/google-apis-servicecontrol_v1/google-apis-servicecontrol_v1.gemspec +++ b/generated/google-apis-servicecontrol_v1/google-apis-servicecontrol_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicecontrolV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Control API V1" + gem.summary = "Simple REST client for Service Control API V1" gem.description = - "This is the legacy REST client for Service Control API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Control API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicecontrol_v1/lib/google/apis/servicecontrol_v1/gem_version.rb b/generated/google-apis-servicecontrol_v1/lib/google/apis/servicecontrol_v1/gem_version.rb index bbbb73e4f..baf531bf4 100644 --- a/generated/google-apis-servicecontrol_v1/lib/google/apis/servicecontrol_v1/gem_version.rb +++ b/generated/google-apis-servicecontrol_v1/lib/google/apis/servicecontrol_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-servicecontrol_v2/CHANGELOG.md b/generated/google-apis-servicecontrol_v2/CHANGELOG.md index f6df90ee7..0f140653f 100644 --- a/generated/google-apis-servicecontrol_v2/CHANGELOG.md +++ b/generated/google-apis-servicecontrol_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-servicecontrol_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-servicecontrol_v2/OVERVIEW.md b/generated/google-apis-servicecontrol_v2/OVERVIEW.md index 2f6d5cda6..c481a3206 100644 --- a/generated/google-apis-servicecontrol_v2/OVERVIEW.md +++ b/generated/google-apis-servicecontrol_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Service Control API +# Simple REST client for version V2 of the Service Control API This is a simple client library for version V2 of the Service Control API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Service Control API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicecontrol service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicecontrol service in particular.) For reference information on specific calls in the Service Control API, see the {Google::Apis::ServicecontrolV2::ServiceControlService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicecontrol_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicecontrol_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-control/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicecontrol_v2/google-apis-servicecontrol_v2.gemspec b/generated/google-apis-servicecontrol_v2/google-apis-servicecontrol_v2.gemspec index 7a12ec138..7ff442c20 100644 --- a/generated/google-apis-servicecontrol_v2/google-apis-servicecontrol_v2.gemspec +++ b/generated/google-apis-servicecontrol_v2/google-apis-servicecontrol_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicecontrolV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Control API V2" + gem.summary = "Simple REST client for Service Control API V2" gem.description = - "This is the legacy REST client for Service Control API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Control API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicecontrol_v2/lib/google/apis/servicecontrol_v2/gem_version.rb b/generated/google-apis-servicecontrol_v2/lib/google/apis/servicecontrol_v2/gem_version.rb index 081f10ffb..e2dfa27fa 100644 --- a/generated/google-apis-servicecontrol_v2/lib/google/apis/servicecontrol_v2/gem_version.rb +++ b/generated/google-apis-servicecontrol_v2/lib/google/apis/servicecontrol_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-servicedirectory_v1/CHANGELOG.md b/generated/google-apis-servicedirectory_v1/CHANGELOG.md index 2f559afdb..b0a3b0419 100644 --- a/generated/google-apis-servicedirectory_v1/CHANGELOG.md +++ b/generated/google-apis-servicedirectory_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-servicedirectory_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-servicedirectory_v1/OVERVIEW.md b/generated/google-apis-servicedirectory_v1/OVERVIEW.md index 0e39474fd..95ee7afbf 100644 --- a/generated/google-apis-servicedirectory_v1/OVERVIEW.md +++ b/generated/google-apis-servicedirectory_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Directory API +# Simple REST client for version V1 of the Service Directory API This is a simple client library for version V1 of the Service Directory API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Directory API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicedirectory service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicedirectory service in particular.) For reference information on specific calls in the Service Directory API, see the {Google::Apis::ServicedirectoryV1::ServiceDirectoryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicedirectory_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicedirectory_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-directory) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicedirectory_v1/google-apis-servicedirectory_v1.gemspec b/generated/google-apis-servicedirectory_v1/google-apis-servicedirectory_v1.gemspec index 33d31e120..b1612a32f 100644 --- a/generated/google-apis-servicedirectory_v1/google-apis-servicedirectory_v1.gemspec +++ b/generated/google-apis-servicedirectory_v1/google-apis-servicedirectory_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicedirectoryV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Directory API V1" + gem.summary = "Simple REST client for Service Directory API V1" gem.description = - "This is the legacy REST client for Service Directory API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Directory API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicedirectory_v1/lib/google/apis/servicedirectory_v1/gem_version.rb b/generated/google-apis-servicedirectory_v1/lib/google/apis/servicedirectory_v1/gem_version.rb index 6d3bf7cf0..7da2ccf71 100644 --- a/generated/google-apis-servicedirectory_v1/lib/google/apis/servicedirectory_v1/gem_version.rb +++ b/generated/google-apis-servicedirectory_v1/lib/google/apis/servicedirectory_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-servicedirectory_v1beta1/CHANGELOG.md b/generated/google-apis-servicedirectory_v1beta1/CHANGELOG.md index 1aa1591f0..56f9a7145 100644 --- a/generated/google-apis-servicedirectory_v1beta1/CHANGELOG.md +++ b/generated/google-apis-servicedirectory_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-servicedirectory_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-servicedirectory_v1beta1/OVERVIEW.md b/generated/google-apis-servicedirectory_v1beta1/OVERVIEW.md index 91a9a6dd2..fb9baa496 100644 --- a/generated/google-apis-servicedirectory_v1beta1/OVERVIEW.md +++ b/generated/google-apis-servicedirectory_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Service Directory API +# Simple REST client for version V1beta1 of the Service Directory API This is a simple client library for version V1beta1 of the Service Directory API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Service Directory API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicedirectory service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicedirectory service in particular.) For reference information on specific calls in the Service Directory API, see the {Google::Apis::ServicedirectoryV1beta1::ServiceDirectoryService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicedirectory_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicedirectory_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-directory) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicedirectory_v1beta1/google-apis-servicedirectory_v1beta1.gemspec b/generated/google-apis-servicedirectory_v1beta1/google-apis-servicedirectory_v1beta1.gemspec index 51bc063bf..be3e88eae 100644 --- a/generated/google-apis-servicedirectory_v1beta1/google-apis-servicedirectory_v1beta1.gemspec +++ b/generated/google-apis-servicedirectory_v1beta1/google-apis-servicedirectory_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicedirectoryV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Directory API V1beta1" + gem.summary = "Simple REST client for Service Directory API V1beta1" gem.description = - "This is the legacy REST client for Service Directory API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Directory API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicedirectory_v1beta1/lib/google/apis/servicedirectory_v1beta1/gem_version.rb b/generated/google-apis-servicedirectory_v1beta1/lib/google/apis/servicedirectory_v1beta1/gem_version.rb index 8b5653dcd..2a09938f1 100644 --- a/generated/google-apis-servicedirectory_v1beta1/lib/google/apis/servicedirectory_v1beta1/gem_version.rb +++ b/generated/google-apis-servicedirectory_v1beta1/lib/google/apis/servicedirectory_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-servicemanagement_v1/CHANGELOG.md b/generated/google-apis-servicemanagement_v1/CHANGELOG.md index cd070ce60..2b6790887 100644 --- a/generated/google-apis-servicemanagement_v1/CHANGELOG.md +++ b/generated/google-apis-servicemanagement_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-servicemanagement_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201211 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-servicemanagement_v1/OVERVIEW.md b/generated/google-apis-servicemanagement_v1/OVERVIEW.md index 39fd63d99..3aa90ec3d 100644 --- a/generated/google-apis-servicemanagement_v1/OVERVIEW.md +++ b/generated/google-apis-servicemanagement_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Management API +# Simple REST client for version V1 of the Service Management API This is a simple client library for version V1 of the Service Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Management API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicemanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicemanagement service in particular.) For reference information on specific calls in the Service Management API, see the {Google::Apis::ServicemanagementV1::ServiceManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicemanagement_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicemanagement_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-management/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicemanagement_v1/google-apis-servicemanagement_v1.gemspec b/generated/google-apis-servicemanagement_v1/google-apis-servicemanagement_v1.gemspec index e6e3c491a..de3990127 100644 --- a/generated/google-apis-servicemanagement_v1/google-apis-servicemanagement_v1.gemspec +++ b/generated/google-apis-servicemanagement_v1/google-apis-servicemanagement_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicemanagementV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Management API V1" + gem.summary = "Simple REST client for Service Management API V1" gem.description = - "This is the legacy REST client for Service Management API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Management API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicemanagement_v1/lib/google/apis/servicemanagement_v1/gem_version.rb b/generated/google-apis-servicemanagement_v1/lib/google/apis/servicemanagement_v1/gem_version.rb index 0eac9cea3..2625a3508 100644 --- a/generated/google-apis-servicemanagement_v1/lib/google/apis/servicemanagement_v1/gem_version.rb +++ b/generated/google-apis-servicemanagement_v1/lib/google/apis/servicemanagement_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201211" diff --git a/generated/google-apis-servicenetworking_v1/OVERVIEW.md b/generated/google-apis-servicenetworking_v1/OVERVIEW.md index 2d395ada5..aa181d68f 100644 --- a/generated/google-apis-servicenetworking_v1/OVERVIEW.md +++ b/generated/google-apis-servicenetworking_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Networking API +# Simple REST client for version V1 of the Service Networking API This is a simple client library for version V1 of the Service Networking API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Networking API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicenetworking service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicenetworking service in particular.) For reference information on specific calls in the Service Networking API, see the {Google::Apis::ServicenetworkingV1::ServiceNetworkingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicenetworking_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicenetworking_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicenetworking_v1/google-apis-servicenetworking_v1.gemspec b/generated/google-apis-servicenetworking_v1/google-apis-servicenetworking_v1.gemspec index 86865a354..178c54884 100644 --- a/generated/google-apis-servicenetworking_v1/google-apis-servicenetworking_v1.gemspec +++ b/generated/google-apis-servicenetworking_v1/google-apis-servicenetworking_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicenetworkingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Networking API V1" + gem.summary = "Simple REST client for Service Networking API V1" gem.description = - "This is the legacy REST client for Service Networking API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Networking API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-servicenetworking_v1beta/OVERVIEW.md b/generated/google-apis-servicenetworking_v1beta/OVERVIEW.md index e6da24585..1debe8bc3 100644 --- a/generated/google-apis-servicenetworking_v1beta/OVERVIEW.md +++ b/generated/google-apis-servicenetworking_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Service Networking API +# Simple REST client for version V1beta of the Service Networking API This is a simple client library for version V1beta of the Service Networking API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Service Networking API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Servicenetworking service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Servicenetworking service in particular.) For reference information on specific calls in the Service Networking API, see the {Google::Apis::ServicenetworkingV1beta::ServiceNetworkingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-servicenetworking_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-servicenetworking_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-servicenetworking_v1beta/google-apis-servicenetworking_v1beta.gemspec b/generated/google-apis-servicenetworking_v1beta/google-apis-servicenetworking_v1beta.gemspec index 5a79514ec..45397d4f5 100644 --- a/generated/google-apis-servicenetworking_v1beta/google-apis-servicenetworking_v1beta.gemspec +++ b/generated/google-apis-servicenetworking_v1beta/google-apis-servicenetworking_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServicenetworkingV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Networking API V1beta" + gem.summary = "Simple REST client for Service Networking API V1beta" gem.description = - "This is the legacy REST client for Service Networking API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Networking API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceusage_v1/CHANGELOG.md b/generated/google-apis-serviceusage_v1/CHANGELOG.md index 2c552f16f..dcdccad50 100644 --- a/generated/google-apis-serviceusage_v1/CHANGELOG.md +++ b/generated/google-apis-serviceusage_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-serviceusage_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-serviceusage_v1/OVERVIEW.md b/generated/google-apis-serviceusage_v1/OVERVIEW.md index ff70330ba..992f77021 100644 --- a/generated/google-apis-serviceusage_v1/OVERVIEW.md +++ b/generated/google-apis-serviceusage_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Service Usage API +# Simple REST client for version V1 of the Service Usage API This is a simple client library for version V1 of the Service Usage API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Service Usage API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Serviceusage service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Serviceusage service in particular.) For reference information on specific calls in the Service Usage API, see the {Google::Apis::ServiceusageV1::ServiceUsageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-serviceusage_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-serviceusage_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-usage/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-serviceusage_v1/google-apis-serviceusage_v1.gemspec b/generated/google-apis-serviceusage_v1/google-apis-serviceusage_v1.gemspec index 95273af27..26420920b 100644 --- a/generated/google-apis-serviceusage_v1/google-apis-serviceusage_v1.gemspec +++ b/generated/google-apis-serviceusage_v1/google-apis-serviceusage_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServiceusageV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Usage API V1" + gem.summary = "Simple REST client for Service Usage API V1" gem.description = - "This is the legacy REST client for Service Usage API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Usage API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceusage_v1/lib/google/apis/serviceusage_v1/gem_version.rb b/generated/google-apis-serviceusage_v1/lib/google/apis/serviceusage_v1/gem_version.rb index 9d7e84ca2..12b520d72 100644 --- a/generated/google-apis-serviceusage_v1/lib/google/apis/serviceusage_v1/gem_version.rb +++ b/generated/google-apis-serviceusage_v1/lib/google/apis/serviceusage_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-serviceusage_v1beta1/CHANGELOG.md b/generated/google-apis-serviceusage_v1beta1/CHANGELOG.md index 015977d58..79ced52bc 100644 --- a/generated/google-apis-serviceusage_v1beta1/CHANGELOG.md +++ b/generated/google-apis-serviceusage_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-serviceusage_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-serviceusage_v1beta1/OVERVIEW.md b/generated/google-apis-serviceusage_v1beta1/OVERVIEW.md index 250cb0516..a55c6f6c2 100644 --- a/generated/google-apis-serviceusage_v1beta1/OVERVIEW.md +++ b/generated/google-apis-serviceusage_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Service Usage API +# Simple REST client for version V1beta1 of the Service Usage API This is a simple client library for version V1beta1 of the Service Usage API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Service Usage API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Serviceusage service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Serviceusage service in particular.) For reference information on specific calls in the Service Usage API, see the {Google::Apis::ServiceusageV1beta1::ServiceUsageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-serviceusage_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-serviceusage_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/service-usage/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-serviceusage_v1beta1/google-apis-serviceusage_v1beta1.gemspec b/generated/google-apis-serviceusage_v1beta1/google-apis-serviceusage_v1beta1.gemspec index d79b5b0f5..d48c605ea 100644 --- a/generated/google-apis-serviceusage_v1beta1/google-apis-serviceusage_v1beta1.gemspec +++ b/generated/google-apis-serviceusage_v1beta1/google-apis-serviceusage_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ServiceusageV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Service Usage API V1beta1" + gem.summary = "Simple REST client for Service Usage API V1beta1" gem.description = - "This is the legacy REST client for Service Usage API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Service Usage API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-serviceusage_v1beta1/lib/google/apis/serviceusage_v1beta1/gem_version.rb b/generated/google-apis-serviceusage_v1beta1/lib/google/apis/serviceusage_v1beta1/gem_version.rb index ba5a3ded0..d1f263867 100644 --- a/generated/google-apis-serviceusage_v1beta1/lib/google/apis/serviceusage_v1beta1/gem_version.rb +++ b/generated/google-apis-serviceusage_v1beta1/lib/google/apis/serviceusage_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-sheets_v4/CHANGELOG.md b/generated/google-apis-sheets_v4/CHANGELOG.md index e8af4927b..d99e79af1 100644 --- a/generated/google-apis-sheets_v4/CHANGELOG.md +++ b/generated/google-apis-sheets_v4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sheets_v4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201130 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sheets_v4/OVERVIEW.md b/generated/google-apis-sheets_v4/OVERVIEW.md index adf4c1b73..db4ea93e2 100644 --- a/generated/google-apis-sheets_v4/OVERVIEW.md +++ b/generated/google-apis-sheets_v4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V4 of the Google Sheets API +# Simple REST client for version V4 of the Google Sheets API This is a simple client library for version V4 of the Google Sheets API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V4 of the Google Sheets API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sheets service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sheets service in particular.) For reference information on specific calls in the Google Sheets API, see the {Google::Apis::SheetsV4::SheetsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sheets_v4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sheets_v4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/sheets/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sheets_v4/google-apis-sheets_v4.gemspec b/generated/google-apis-sheets_v4/google-apis-sheets_v4.gemspec index 8ff19d2b4..2dfb69579 100644 --- a/generated/google-apis-sheets_v4/google-apis-sheets_v4.gemspec +++ b/generated/google-apis-sheets_v4/google-apis-sheets_v4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SheetsV4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Sheets API V4" + gem.summary = "Simple REST client for Google Sheets API V4" gem.description = - "This is the legacy REST client for Google Sheets API V4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Sheets API V4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/gem_version.rb b/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/gem_version.rb index 615cb1559..7ddafba6c 100644 --- a/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/gem_version.rb +++ b/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201130" diff --git a/generated/google-apis-site_verification_v1/CHANGELOG.md b/generated/google-apis-site_verification_v1/CHANGELOG.md index ca6527df1..0ec213c08 100644 --- a/generated/google-apis-site_verification_v1/CHANGELOG.md +++ b/generated/google-apis-site_verification_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-site_verification_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20191119 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-site_verification_v1/OVERVIEW.md b/generated/google-apis-site_verification_v1/OVERVIEW.md index 5572af51d..a3a24e0b6 100644 --- a/generated/google-apis-site_verification_v1/OVERVIEW.md +++ b/generated/google-apis-site_verification_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Site Verification API +# Simple REST client for version V1 of the Google Site Verification API This is a simple client library for version V1 of the Google Site Verification API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Site Verification A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the SiteVerification service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the SiteVerification service in particular.) For reference information on specific calls in the Google Site Verification API, see the {Google::Apis::SiteVerificationV1::SiteVerificationService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-site_verification_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-site_verification_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/site-verification/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-site_verification_v1/google-apis-site_verification_v1.gemspec b/generated/google-apis-site_verification_v1/google-apis-site_verification_v1.gemspec index 7a91627bb..9a7dfef91 100644 --- a/generated/google-apis-site_verification_v1/google-apis-site_verification_v1.gemspec +++ b/generated/google-apis-site_verification_v1/google-apis-site_verification_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SiteVerificationV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Site Verification API V1" + gem.summary = "Simple REST client for Google Site Verification API V1" gem.description = - "This is the legacy REST client for Google Site Verification API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Site Verification API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-site_verification_v1/lib/google/apis/site_verification_v1/gem_version.rb b/generated/google-apis-site_verification_v1/lib/google/apis/site_verification_v1/gem_version.rb index 6c4057629..ebd7c5069 100644 --- a/generated/google-apis-site_verification_v1/lib/google/apis/site_verification_v1/gem_version.rb +++ b/generated/google-apis-site_verification_v1/lib/google/apis/site_verification_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20191119" diff --git a/generated/google-apis-slides_v1/CHANGELOG.md b/generated/google-apis-slides_v1/CHANGELOG.md index 6a45a11d8..d817a71db 100644 --- a/generated/google-apis-slides_v1/CHANGELOG.md +++ b/generated/google-apis-slides_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-slides_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201201 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-slides_v1/OVERVIEW.md b/generated/google-apis-slides_v1/OVERVIEW.md index 7b122b8c0..808012cfe 100644 --- a/generated/google-apis-slides_v1/OVERVIEW.md +++ b/generated/google-apis-slides_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Google Slides API +# Simple REST client for version V1 of the Google Slides API This is a simple client library for version V1 of the Google Slides API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Google Slides API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Slides service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Slides service in particular.) For reference information on specific calls in the Google Slides API, see the {Google::Apis::SlidesV1::SlidesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-slides_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-slides_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/slides/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-slides_v1/google-apis-slides_v1.gemspec b/generated/google-apis-slides_v1/google-apis-slides_v1.gemspec index afce6bc76..2eff51df8 100644 --- a/generated/google-apis-slides_v1/google-apis-slides_v1.gemspec +++ b/generated/google-apis-slides_v1/google-apis-slides_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SlidesV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Slides API V1" + gem.summary = "Simple REST client for Google Slides API V1" gem.description = - "This is the legacy REST client for Google Slides API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Slides API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-slides_v1/lib/google/apis/slides_v1/gem_version.rb b/generated/google-apis-slides_v1/lib/google/apis/slides_v1/gem_version.rb index b6fb5fc25..0e4a3f1a5 100644 --- a/generated/google-apis-slides_v1/lib/google/apis/slides_v1/gem_version.rb +++ b/generated/google-apis-slides_v1/lib/google/apis/slides_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201201" diff --git a/generated/google-apis-smartdevicemanagement_v1/CHANGELOG.md b/generated/google-apis-smartdevicemanagement_v1/CHANGELOG.md index 5f88984ac..604742f3f 100644 --- a/generated/google-apis-smartdevicemanagement_v1/CHANGELOG.md +++ b/generated/google-apis-smartdevicemanagement_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-smartdevicemanagement_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201022 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-smartdevicemanagement_v1/OVERVIEW.md b/generated/google-apis-smartdevicemanagement_v1/OVERVIEW.md index b85f129ae..ef01b0e66 100644 --- a/generated/google-apis-smartdevicemanagement_v1/OVERVIEW.md +++ b/generated/google-apis-smartdevicemanagement_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Smart Device Management API +# Simple REST client for version V1 of the Smart Device Management API This is a simple client library for version V1 of the Smart Device Management API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Smart Device Management AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Smartdevicemanagement service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Smartdevicemanagement service in particular.) For reference information on specific calls in the Smart Device Management API, see the {Google::Apis::SmartdevicemanagementV1::SmartDeviceManagementService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-smartdevicemanagement_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-smartdevicemanagement_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/nest/device-access) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-smartdevicemanagement_v1/google-apis-smartdevicemanagement_v1.gemspec b/generated/google-apis-smartdevicemanagement_v1/google-apis-smartdevicemanagement_v1.gemspec index e407a248d..7827a38b8 100644 --- a/generated/google-apis-smartdevicemanagement_v1/google-apis-smartdevicemanagement_v1.gemspec +++ b/generated/google-apis-smartdevicemanagement_v1/google-apis-smartdevicemanagement_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SmartdevicemanagementV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Smart Device Management API V1" + gem.summary = "Simple REST client for Smart Device Management API V1" gem.description = - "This is the legacy REST client for Smart Device Management API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Smart Device Management API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-smartdevicemanagement_v1/lib/google/apis/smartdevicemanagement_v1/gem_version.rb b/generated/google-apis-smartdevicemanagement_v1/lib/google/apis/smartdevicemanagement_v1/gem_version.rb index 93b66c46b..277ea1da9 100644 --- a/generated/google-apis-smartdevicemanagement_v1/lib/google/apis/smartdevicemanagement_v1/gem_version.rb +++ b/generated/google-apis-smartdevicemanagement_v1/lib/google/apis/smartdevicemanagement_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201022" diff --git a/generated/google-apis-sourcerepo_v1/CHANGELOG.md b/generated/google-apis-sourcerepo_v1/CHANGELOG.md index e0c4277f8..cc4f59c94 100644 --- a/generated/google-apis-sourcerepo_v1/CHANGELOG.md +++ b/generated/google-apis-sourcerepo_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sourcerepo_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200914 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sourcerepo_v1/OVERVIEW.md b/generated/google-apis-sourcerepo_v1/OVERVIEW.md index ff4614407..6253d3d14 100644 --- a/generated/google-apis-sourcerepo_v1/OVERVIEW.md +++ b/generated/google-apis-sourcerepo_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Source Repositories API +# Simple REST client for version V1 of the Cloud Source Repositories API This is a simple client library for version V1 of the Cloud Source Repositories API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Source Repositories * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sourcerepo service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sourcerepo service in particular.) For reference information on specific calls in the Cloud Source Repositories API, see the {Google::Apis::SourcerepoV1::CloudSourceRepositoriesService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sourcerepo_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sourcerepo_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/source-repositories/docs/apis) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sourcerepo_v1/google-apis-sourcerepo_v1.gemspec b/generated/google-apis-sourcerepo_v1/google-apis-sourcerepo_v1.gemspec index 88adad7d7..acce3be17 100644 --- a/generated/google-apis-sourcerepo_v1/google-apis-sourcerepo_v1.gemspec +++ b/generated/google-apis-sourcerepo_v1/google-apis-sourcerepo_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SourcerepoV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Source Repositories API V1" + gem.summary = "Simple REST client for Cloud Source Repositories API V1" gem.description = - "This is the legacy REST client for Cloud Source Repositories API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Source Repositories API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sourcerepo_v1/lib/google/apis/sourcerepo_v1/gem_version.rb b/generated/google-apis-sourcerepo_v1/lib/google/apis/sourcerepo_v1/gem_version.rb index 08b6e6ee6..24e67dfa2 100644 --- a/generated/google-apis-sourcerepo_v1/lib/google/apis/sourcerepo_v1/gem_version.rb +++ b/generated/google-apis-sourcerepo_v1/lib/google/apis/sourcerepo_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200914" diff --git a/generated/google-apis-spanner_v1/CHANGELOG.md b/generated/google-apis-spanner_v1/CHANGELOG.md index 8998d185e..09769fe0d 100644 --- a/generated/google-apis-spanner_v1/CHANGELOG.md +++ b/generated/google-apis-spanner_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-spanner_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201130 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-spanner_v1/OVERVIEW.md b/generated/google-apis-spanner_v1/OVERVIEW.md index 0073b3b59..4262798f7 100644 --- a/generated/google-apis-spanner_v1/OVERVIEW.md +++ b/generated/google-apis-spanner_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Spanner API +# Simple REST client for version V1 of the Cloud Spanner API This is a simple client library for version V1 of the Cloud Spanner API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Spanner API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Spanner service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Spanner service in particular.) For reference information on specific calls in the Cloud Spanner API, see the {Google::Apis::SpannerV1::SpannerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-spanner_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-spanner_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/spanner/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-spanner_v1/google-apis-spanner_v1.gemspec b/generated/google-apis-spanner_v1/google-apis-spanner_v1.gemspec index 0095f627f..48e36dcc1 100644 --- a/generated/google-apis-spanner_v1/google-apis-spanner_v1.gemspec +++ b/generated/google-apis-spanner_v1/google-apis-spanner_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SpannerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Spanner API V1" + gem.summary = "Simple REST client for Cloud Spanner API V1" gem.description = - "This is the legacy REST client for Cloud Spanner API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Spanner API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/gem_version.rb b/generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/gem_version.rb index 13e676c27..069904afe 100644 --- a/generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/gem_version.rb +++ b/generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201130" diff --git a/generated/google-apis-speech_v1/CHANGELOG.md b/generated/google-apis-speech_v1/CHANGELOG.md index 51eb727d2..94a0434d1 100644 --- a/generated/google-apis-speech_v1/CHANGELOG.md +++ b/generated/google-apis-speech_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-speech_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200824 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-speech_v1/OVERVIEW.md b/generated/google-apis-speech_v1/OVERVIEW.md index fdd423d64..7b4e7d23b 100644 --- a/generated/google-apis-speech_v1/OVERVIEW.md +++ b/generated/google-apis-speech_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Speech-to-Text API +# Simple REST client for version V1 of the Cloud Speech-to-Text API This is a simple client library for version V1 of the Cloud Speech-to-Text API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Speech-to-Text API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Speech service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Speech service in particular.) For reference information on specific calls in the Cloud Speech-to-Text API, see the {Google::Apis::SpeechV1::SpeechService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-speech_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-speech_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/speech-to-text/docs/quickstart-protocol) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-speech_v1/google-apis-speech_v1.gemspec b/generated/google-apis-speech_v1/google-apis-speech_v1.gemspec index 2de71fe7c..479f4743e 100644 --- a/generated/google-apis-speech_v1/google-apis-speech_v1.gemspec +++ b/generated/google-apis-speech_v1/google-apis-speech_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SpeechV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Speech-to-Text API V1" + gem.summary = "Simple REST client for Cloud Speech-to-Text API V1" gem.description = - "This is the legacy REST client for Cloud Speech-to-Text API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Speech-to-Text API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-speech_v1/lib/google/apis/speech_v1/gem_version.rb b/generated/google-apis-speech_v1/lib/google/apis/speech_v1/gem_version.rb index 61c1a0eae..083cdd2aa 100644 --- a/generated/google-apis-speech_v1/lib/google/apis/speech_v1/gem_version.rb +++ b/generated/google-apis-speech_v1/lib/google/apis/speech_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200824" diff --git a/generated/google-apis-speech_v1p1beta1/CHANGELOG.md b/generated/google-apis-speech_v1p1beta1/CHANGELOG.md index 9ac81c1bb..df21788d8 100644 --- a/generated/google-apis-speech_v1p1beta1/CHANGELOG.md +++ b/generated/google-apis-speech_v1p1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-speech_v1p1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-speech_v1p1beta1/OVERVIEW.md b/generated/google-apis-speech_v1p1beta1/OVERVIEW.md index 2e588e4f6..1f58463ae 100644 --- a/generated/google-apis-speech_v1p1beta1/OVERVIEW.md +++ b/generated/google-apis-speech_v1p1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p1beta1 of the Cloud Speech-to-Text API +# Simple REST client for version V1p1beta1 of the Cloud Speech-to-Text API This is a simple client library for version V1p1beta1 of the Cloud Speech-to-Text API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p1beta1 of the Cloud Speech-to-Tex * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Speech service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Speech service in particular.) For reference information on specific calls in the Cloud Speech-to-Text API, see the {Google::Apis::SpeechV1p1beta1::SpeechService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-speech_v1p1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-speech_v1p1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/speech-to-text/docs/quickstart-protocol) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-speech_v1p1beta1/google-apis-speech_v1p1beta1.gemspec b/generated/google-apis-speech_v1p1beta1/google-apis-speech_v1p1beta1.gemspec index 2cd5537ef..c6a91efaa 100644 --- a/generated/google-apis-speech_v1p1beta1/google-apis-speech_v1p1beta1.gemspec +++ b/generated/google-apis-speech_v1p1beta1/google-apis-speech_v1p1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SpeechV1p1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Speech-to-Text API V1p1beta1" + gem.summary = "Simple REST client for Cloud Speech-to-Text API V1p1beta1" gem.description = - "This is the legacy REST client for Cloud Speech-to-Text API V1p1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Speech-to-Text API V1p1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-speech_v1p1beta1/lib/google/apis/speech_v1p1beta1/gem_version.rb b/generated/google-apis-speech_v1p1beta1/lib/google/apis/speech_v1p1beta1/gem_version.rb index f778e3362..4477786fd 100644 --- a/generated/google-apis-speech_v1p1beta1/lib/google/apis/speech_v1p1beta1/gem_version.rb +++ b/generated/google-apis-speech_v1p1beta1/lib/google/apis/speech_v1p1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-speech_v2beta1/CHANGELOG.md b/generated/google-apis-speech_v2beta1/CHANGELOG.md index f2c8812c4..f3a89aef0 100644 --- a/generated/google-apis-speech_v2beta1/CHANGELOG.md +++ b/generated/google-apis-speech_v2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-speech_v2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200824 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-speech_v2beta1/OVERVIEW.md b/generated/google-apis-speech_v2beta1/OVERVIEW.md index 0bb3c5763..c240df720 100644 --- a/generated/google-apis-speech_v2beta1/OVERVIEW.md +++ b/generated/google-apis-speech_v2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2beta1 of the Cloud Speech-to-Text API +# Simple REST client for version V2beta1 of the Cloud Speech-to-Text API This is a simple client library for version V2beta1 of the Cloud Speech-to-Text API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2beta1 of the Cloud Speech-to-Text * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Speech service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Speech service in particular.) For reference information on specific calls in the Cloud Speech-to-Text API, see the {Google::Apis::SpeechV2beta1::SpeechService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-speech_v2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-speech_v2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/speech-to-text/docs/quickstart-protocol) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-speech_v2beta1/google-apis-speech_v2beta1.gemspec b/generated/google-apis-speech_v2beta1/google-apis-speech_v2beta1.gemspec index 774717ee9..a32769aeb 100644 --- a/generated/google-apis-speech_v2beta1/google-apis-speech_v2beta1.gemspec +++ b/generated/google-apis-speech_v2beta1/google-apis-speech_v2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SpeechV2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Speech-to-Text API V2beta1" + gem.summary = "Simple REST client for Cloud Speech-to-Text API V2beta1" gem.description = - "This is the legacy REST client for Cloud Speech-to-Text API V2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Speech-to-Text API V2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-speech_v2beta1/lib/google/apis/speech_v2beta1/gem_version.rb b/generated/google-apis-speech_v2beta1/lib/google/apis/speech_v2beta1/gem_version.rb index e7daee688..7ebf693a9 100644 --- a/generated/google-apis-speech_v2beta1/lib/google/apis/speech_v2beta1/gem_version.rb +++ b/generated/google-apis-speech_v2beta1/lib/google/apis/speech_v2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200824" diff --git a/generated/google-apis-sqladmin_v1beta4/CHANGELOG.md b/generated/google-apis-sqladmin_v1beta4/CHANGELOG.md index d623d3f8b..22f2cb06c 100644 --- a/generated/google-apis-sqladmin_v1beta4/CHANGELOG.md +++ b/generated/google-apis-sqladmin_v1beta4/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sqladmin_v1beta4 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201205 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sqladmin_v1beta4/OVERVIEW.md b/generated/google-apis-sqladmin_v1beta4/OVERVIEW.md index b1f481df1..17503fb0a 100644 --- a/generated/google-apis-sqladmin_v1beta4/OVERVIEW.md +++ b/generated/google-apis-sqladmin_v1beta4/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta4 of the Cloud SQL Admin API +# Simple REST client for version V1beta4 of the Cloud SQL Admin API This is a simple client library for version V1beta4 of the Cloud SQL Admin API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta4 of the Cloud SQL Admin API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sqladmin service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sqladmin service in particular.) For reference information on specific calls in the Cloud SQL Admin API, see the {Google::Apis::SqladminV1beta4::SQLAdminService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sqladmin_v1beta4`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sqladmin_v1beta4`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/cloud-sql/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sqladmin_v1beta4/google-apis-sqladmin_v1beta4.gemspec b/generated/google-apis-sqladmin_v1beta4/google-apis-sqladmin_v1beta4.gemspec index 624dff52f..49301ecba 100644 --- a/generated/google-apis-sqladmin_v1beta4/google-apis-sqladmin_v1beta4.gemspec +++ b/generated/google-apis-sqladmin_v1beta4/google-apis-sqladmin_v1beta4.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::SqladminV1beta4::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud SQL Admin API V1beta4" + gem.summary = "Simple REST client for Cloud SQL Admin API V1beta4" gem.description = - "This is the legacy REST client for Cloud SQL Admin API V1beta4." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud SQL Admin API V1beta4." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sqladmin_v1beta4/lib/google/apis/sqladmin_v1beta4/gem_version.rb b/generated/google-apis-sqladmin_v1beta4/lib/google/apis/sqladmin_v1beta4/gem_version.rb index 8ab04516e..f65fdfdc0 100644 --- a/generated/google-apis-sqladmin_v1beta4/lib/google/apis/sqladmin_v1beta4/gem_version.rb +++ b/generated/google-apis-sqladmin_v1beta4/lib/google/apis/sqladmin_v1beta4/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201205" diff --git a/generated/google-apis-storage_v1/CHANGELOG.md b/generated/google-apis-storage_v1/CHANGELOG.md index 2c56195dd..5778561a1 100644 --- a/generated/google-apis-storage_v1/CHANGELOG.md +++ b/generated/google-apis-storage_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-storage_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201112 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-storage_v1/OVERVIEW.md b/generated/google-apis-storage_v1/OVERVIEW.md index a15866782..68a8de275 100644 --- a/generated/google-apis-storage_v1/OVERVIEW.md +++ b/generated/google-apis-storage_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Storage JSON API +# Simple REST client for version V1 of the Cloud Storage JSON API This is a simple client library for version V1 of the Cloud Storage JSON API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Storage JSON API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Storage service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Storage service in particular.) For reference information on specific calls in the Cloud Storage JSON API, see the {Google::Apis::StorageV1::StorageService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-storage_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-storage_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/storage/docs/json_api/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-storage_v1/google-apis-storage_v1.gemspec b/generated/google-apis-storage_v1/google-apis-storage_v1.gemspec index 10b6b00d6..7fa14cd53 100644 --- a/generated/google-apis-storage_v1/google-apis-storage_v1.gemspec +++ b/generated/google-apis-storage_v1/google-apis-storage_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::StorageV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Storage JSON API V1" + gem.summary = "Simple REST client for Cloud Storage JSON API V1" gem.description = - "This is the legacy REST client for Cloud Storage JSON API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Storage JSON API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-storage_v1/lib/google/apis/storage_v1/gem_version.rb b/generated/google-apis-storage_v1/lib/google/apis/storage_v1/gem_version.rb index 74dbd7d3d..718ef41bd 100644 --- a/generated/google-apis-storage_v1/lib/google/apis/storage_v1/gem_version.rb +++ b/generated/google-apis-storage_v1/lib/google/apis/storage_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201112" diff --git a/generated/google-apis-storagetransfer_v1/CHANGELOG.md b/generated/google-apis-storagetransfer_v1/CHANGELOG.md index 7fca9d80d..3fb05d6ef 100644 --- a/generated/google-apis-storagetransfer_v1/CHANGELOG.md +++ b/generated/google-apis-storagetransfer_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-storagetransfer_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201210 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-storagetransfer_v1/OVERVIEW.md b/generated/google-apis-storagetransfer_v1/OVERVIEW.md index a28d979e2..8d5563129 100644 --- a/generated/google-apis-storagetransfer_v1/OVERVIEW.md +++ b/generated/google-apis-storagetransfer_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Storage Transfer API +# Simple REST client for version V1 of the Storage Transfer API This is a simple client library for version V1 of the Storage Transfer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Storage Transfer API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Storagetransfer service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Storagetransfer service in particular.) For reference information on specific calls in the Storage Transfer API, see the {Google::Apis::StoragetransferV1::StoragetransferService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-storagetransfer_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-storagetransfer_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/storage-transfer/docs) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-storagetransfer_v1/google-apis-storagetransfer_v1.gemspec b/generated/google-apis-storagetransfer_v1/google-apis-storagetransfer_v1.gemspec index 2a9b4f0fd..95ab0fe0b 100644 --- a/generated/google-apis-storagetransfer_v1/google-apis-storagetransfer_v1.gemspec +++ b/generated/google-apis-storagetransfer_v1/google-apis-storagetransfer_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::StoragetransferV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Storage Transfer API V1" + gem.summary = "Simple REST client for Storage Transfer API V1" gem.description = - "This is the legacy REST client for Storage Transfer API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Storage Transfer API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-storagetransfer_v1/lib/google/apis/storagetransfer_v1/gem_version.rb b/generated/google-apis-storagetransfer_v1/lib/google/apis/storagetransfer_v1/gem_version.rb index d61058de3..69ce552d0 100644 --- a/generated/google-apis-storagetransfer_v1/lib/google/apis/storagetransfer_v1/gem_version.rb +++ b/generated/google-apis-storagetransfer_v1/lib/google/apis/storagetransfer_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201210" diff --git a/generated/google-apis-streetviewpublish_v1/CHANGELOG.md b/generated/google-apis-streetviewpublish_v1/CHANGELOG.md index 66b732ff8..c0404bd69 100644 --- a/generated/google-apis-streetviewpublish_v1/CHANGELOG.md +++ b/generated/google-apis-streetviewpublish_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-streetviewpublish_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201012 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-streetviewpublish_v1/OVERVIEW.md b/generated/google-apis-streetviewpublish_v1/OVERVIEW.md index 7e157aaf5..9df76a5ae 100644 --- a/generated/google-apis-streetviewpublish_v1/OVERVIEW.md +++ b/generated/google-apis-streetviewpublish_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Street View Publish API +# Simple REST client for version V1 of the Street View Publish API This is a simple client library for version V1 of the Street View Publish API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Street View Publish API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Streetviewpublish service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Streetviewpublish service in particular.) For reference information on specific calls in the Street View Publish API, see the {Google::Apis::StreetviewpublishV1::StreetViewPublishService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-streetviewpublish_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-streetviewpublish_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/streetview/publish/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-streetviewpublish_v1/google-apis-streetviewpublish_v1.gemspec b/generated/google-apis-streetviewpublish_v1/google-apis-streetviewpublish_v1.gemspec index bbfd4def5..765ad6b29 100644 --- a/generated/google-apis-streetviewpublish_v1/google-apis-streetviewpublish_v1.gemspec +++ b/generated/google-apis-streetviewpublish_v1/google-apis-streetviewpublish_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::StreetviewpublishV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Street View Publish API V1" + gem.summary = "Simple REST client for Street View Publish API V1" gem.description = - "This is the legacy REST client for Street View Publish API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Street View Publish API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-streetviewpublish_v1/lib/google/apis/streetviewpublish_v1/gem_version.rb b/generated/google-apis-streetviewpublish_v1/lib/google/apis/streetviewpublish_v1/gem_version.rb index 9d1cb6c16..0d12207a1 100644 --- a/generated/google-apis-streetviewpublish_v1/lib/google/apis/streetviewpublish_v1/gem_version.rb +++ b/generated/google-apis-streetviewpublish_v1/lib/google/apis/streetviewpublish_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201012" diff --git a/generated/google-apis-sts_v1/CHANGELOG.md b/generated/google-apis-sts_v1/CHANGELOG.md index eb6a3332e..3da4411cb 100644 --- a/generated/google-apis-sts_v1/CHANGELOG.md +++ b/generated/google-apis-sts_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sts_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201004 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sts_v1/OVERVIEW.md b/generated/google-apis-sts_v1/OVERVIEW.md index 334d314e2..996e138e1 100644 --- a/generated/google-apis-sts_v1/OVERVIEW.md +++ b/generated/google-apis-sts_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Security Token Service API +# Simple REST client for version V1 of the Security Token Service API This is a simple client library for version V1 of the Security Token Service API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Security Token Service API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sts service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sts service in particular.) For reference information on specific calls in the Security Token Service API, see the {Google::Apis::StsV1::CloudSecurityTokenService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sts_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sts_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://cloud.google.com/iam/docs/workload-identity-federation) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sts_v1/google-apis-sts_v1.gemspec b/generated/google-apis-sts_v1/google-apis-sts_v1.gemspec index 679576f41..9a8d7d028 100644 --- a/generated/google-apis-sts_v1/google-apis-sts_v1.gemspec +++ b/generated/google-apis-sts_v1/google-apis-sts_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::StsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Security Token Service API V1" + gem.summary = "Simple REST client for Security Token Service API V1" gem.description = - "This is the legacy REST client for Security Token Service API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Security Token Service API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sts_v1/lib/google/apis/sts_v1/gem_version.rb b/generated/google-apis-sts_v1/lib/google/apis/sts_v1/gem_version.rb index bd55089cf..fcd077514 100644 --- a/generated/google-apis-sts_v1/lib/google/apis/sts_v1/gem_version.rb +++ b/generated/google-apis-sts_v1/lib/google/apis/sts_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201004" diff --git a/generated/google-apis-sts_v1beta/CHANGELOG.md b/generated/google-apis-sts_v1beta/CHANGELOG.md index 6627f6d00..d4294091e 100644 --- a/generated/google-apis-sts_v1beta/CHANGELOG.md +++ b/generated/google-apis-sts_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-sts_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201009 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-sts_v1beta/OVERVIEW.md b/generated/google-apis-sts_v1beta/OVERVIEW.md index ce7cb112c..debb1796f 100644 --- a/generated/google-apis-sts_v1beta/OVERVIEW.md +++ b/generated/google-apis-sts_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Security Token Service API +# Simple REST client for version V1beta of the Security Token Service API This is a simple client library for version V1beta of the Security Token Service API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Security Token Service * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Sts service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Sts service in particular.) For reference information on specific calls in the Security Token Service API, see the {Google::Apis::StsV1beta::CloudSecurityTokenService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-sts_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-sts_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](http://cloud.google.com/iam/docs/workload-identity-federation) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-sts_v1beta/google-apis-sts_v1beta.gemspec b/generated/google-apis-sts_v1beta/google-apis-sts_v1beta.gemspec index a854b8c8c..1c0645bec 100644 --- a/generated/google-apis-sts_v1beta/google-apis-sts_v1beta.gemspec +++ b/generated/google-apis-sts_v1beta/google-apis-sts_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::StsV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Security Token Service API V1beta" + gem.summary = "Simple REST client for Security Token Service API V1beta" gem.description = - "This is the legacy REST client for Security Token Service API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Security Token Service API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-sts_v1beta/lib/google/apis/sts_v1beta/gem_version.rb b/generated/google-apis-sts_v1beta/lib/google/apis/sts_v1beta/gem_version.rb index 73301b33d..c7f3c504a 100644 --- a/generated/google-apis-sts_v1beta/lib/google/apis/sts_v1beta/gem_version.rb +++ b/generated/google-apis-sts_v1beta/lib/google/apis/sts_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201009" diff --git a/generated/google-apis-tagmanager_v1/CHANGELOG.md b/generated/google-apis-tagmanager_v1/CHANGELOG.md index 4ccf7a131..7d8e9cc45 100644 --- a/generated/google-apis-tagmanager_v1/CHANGELOG.md +++ b/generated/google-apis-tagmanager_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-tagmanager_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200826 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-tagmanager_v1/OVERVIEW.md b/generated/google-apis-tagmanager_v1/OVERVIEW.md index 30fc86cc5..0c3fec408 100644 --- a/generated/google-apis-tagmanager_v1/OVERVIEW.md +++ b/generated/google-apis-tagmanager_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Tag Manager API +# Simple REST client for version V1 of the Tag Manager API This is a simple client library for version V1 of the Tag Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Tag Manager API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Tagmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Tagmanager service in particular.) For reference information on specific calls in the Tag Manager API, see the {Google::Apis::TagmanagerV1::TagManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-tagmanager_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-tagmanager_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/tag-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-tagmanager_v1/google-apis-tagmanager_v1.gemspec b/generated/google-apis-tagmanager_v1/google-apis-tagmanager_v1.gemspec index da755fd76..d074f1ab8 100644 --- a/generated/google-apis-tagmanager_v1/google-apis-tagmanager_v1.gemspec +++ b/generated/google-apis-tagmanager_v1/google-apis-tagmanager_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TagmanagerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Tag Manager API V1" + gem.summary = "Simple REST client for Tag Manager API V1" gem.description = - "This is the legacy REST client for Tag Manager API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Tag Manager API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-tagmanager_v1/lib/google/apis/tagmanager_v1/gem_version.rb b/generated/google-apis-tagmanager_v1/lib/google/apis/tagmanager_v1/gem_version.rb index 64bf4e705..48dd0a7ff 100644 --- a/generated/google-apis-tagmanager_v1/lib/google/apis/tagmanager_v1/gem_version.rb +++ b/generated/google-apis-tagmanager_v1/lib/google/apis/tagmanager_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200826" diff --git a/generated/google-apis-tagmanager_v2/CHANGELOG.md b/generated/google-apis-tagmanager_v2/CHANGELOG.md index ad21ec411..7bc8a182d 100644 --- a/generated/google-apis-tagmanager_v2/CHANGELOG.md +++ b/generated/google-apis-tagmanager_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-tagmanager_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201022 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-tagmanager_v2/OVERVIEW.md b/generated/google-apis-tagmanager_v2/OVERVIEW.md index c2943cbd7..a55569f02 100644 --- a/generated/google-apis-tagmanager_v2/OVERVIEW.md +++ b/generated/google-apis-tagmanager_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Tag Manager API +# Simple REST client for version V2 of the Tag Manager API This is a simple client library for version V2 of the Tag Manager API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Tag Manager API. It provid * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Tagmanager service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Tagmanager service in particular.) For reference information on specific calls in the Tag Manager API, see the {Google::Apis::TagmanagerV2::TagManagerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-tagmanager_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-tagmanager_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/tag-manager) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-tagmanager_v2/google-apis-tagmanager_v2.gemspec b/generated/google-apis-tagmanager_v2/google-apis-tagmanager_v2.gemspec index 161b939a7..37e91eee3 100644 --- a/generated/google-apis-tagmanager_v2/google-apis-tagmanager_v2.gemspec +++ b/generated/google-apis-tagmanager_v2/google-apis-tagmanager_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TagmanagerV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Tag Manager API V2" + gem.summary = "Simple REST client for Tag Manager API V2" gem.description = - "This is the legacy REST client for Tag Manager API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Tag Manager API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-tagmanager_v2/lib/google/apis/tagmanager_v2/gem_version.rb b/generated/google-apis-tagmanager_v2/lib/google/apis/tagmanager_v2/gem_version.rb index 913357812..83aebd2d0 100644 --- a/generated/google-apis-tagmanager_v2/lib/google/apis/tagmanager_v2/gem_version.rb +++ b/generated/google-apis-tagmanager_v2/lib/google/apis/tagmanager_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201022" diff --git a/generated/google-apis-tasks_v1/CHANGELOG.md b/generated/google-apis-tasks_v1/CHANGELOG.md index 882785fa2..674636121 100644 --- a/generated/google-apis-tasks_v1/CHANGELOG.md +++ b/generated/google-apis-tasks_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-tasks_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200905 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-tasks_v1/OVERVIEW.md b/generated/google-apis-tasks_v1/OVERVIEW.md index 99637b30a..2583699a1 100644 --- a/generated/google-apis-tasks_v1/OVERVIEW.md +++ b/generated/google-apis-tasks_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Tasks API +# Simple REST client for version V1 of the Tasks API This is a simple client library for version V1 of the Tasks API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Tasks API. It provides: * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Tasks service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Tasks service in particular.) For reference information on specific calls in the Tasks API, see the {Google::Apis::TasksV1::TasksService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-tasks_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-tasks_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation]() may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-tasks_v1/google-apis-tasks_v1.gemspec b/generated/google-apis-tasks_v1/google-apis-tasks_v1.gemspec index e093de971..a6e2d8781 100644 --- a/generated/google-apis-tasks_v1/google-apis-tasks_v1.gemspec +++ b/generated/google-apis-tasks_v1/google-apis-tasks_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TasksV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Tasks API V1" + gem.summary = "Simple REST client for Tasks API V1" gem.description = - "This is the legacy REST client for Tasks API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Tasks API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-tasks_v1/lib/google/apis/tasks_v1/gem_version.rb b/generated/google-apis-tasks_v1/lib/google/apis/tasks_v1/gem_version.rb index 771d33ae9..f58445e12 100644 --- a/generated/google-apis-tasks_v1/lib/google/apis/tasks_v1/gem_version.rb +++ b/generated/google-apis-tasks_v1/lib/google/apis/tasks_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200905" diff --git a/generated/google-apis-testing_v1/CHANGELOG.md b/generated/google-apis-testing_v1/CHANGELOG.md index df0011964..cd7d1239c 100644 --- a/generated/google-apis-testing_v1/CHANGELOG.md +++ b/generated/google-apis-testing_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-testing_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201208 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-testing_v1/OVERVIEW.md b/generated/google-apis-testing_v1/OVERVIEW.md index d6063fe46..e5867b7a2 100644 --- a/generated/google-apis-testing_v1/OVERVIEW.md +++ b/generated/google-apis-testing_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Testing API +# Simple REST client for version V1 of the Cloud Testing API This is a simple client library for version V1 of the Cloud Testing API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Testing API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Testing service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Testing service in particular.) For reference information on specific calls in the Cloud Testing API, see the {Google::Apis::TestingV1::TestingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-testing_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-testing_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/cloud-test-lab/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-testing_v1/google-apis-testing_v1.gemspec b/generated/google-apis-testing_v1/google-apis-testing_v1.gemspec index 720ff44fd..d019f82c3 100644 --- a/generated/google-apis-testing_v1/google-apis-testing_v1.gemspec +++ b/generated/google-apis-testing_v1/google-apis-testing_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TestingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Testing API V1" + gem.summary = "Simple REST client for Cloud Testing API V1" gem.description = - "This is the legacy REST client for Cloud Testing API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Testing API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-testing_v1/lib/google/apis/testing_v1/gem_version.rb b/generated/google-apis-testing_v1/lib/google/apis/testing_v1/gem_version.rb index d7e5067b4..a1aca8b59 100644 --- a/generated/google-apis-testing_v1/lib/google/apis/testing_v1/gem_version.rb +++ b/generated/google-apis-testing_v1/lib/google/apis/testing_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201208" diff --git a/generated/google-apis-texttospeech_v1/CHANGELOG.md b/generated/google-apis-texttospeech_v1/CHANGELOG.md index 23d3aa01a..0c0a25391 100644 --- a/generated/google-apis-texttospeech_v1/CHANGELOG.md +++ b/generated/google-apis-texttospeech_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-texttospeech_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200814 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-texttospeech_v1/OVERVIEW.md b/generated/google-apis-texttospeech_v1/OVERVIEW.md index 7154093f1..af9a715f0 100644 --- a/generated/google-apis-texttospeech_v1/OVERVIEW.md +++ b/generated/google-apis-texttospeech_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Text-to-Speech API +# Simple REST client for version V1 of the Cloud Text-to-Speech API This is a simple client library for version V1 of the Cloud Text-to-Speech API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Text-to-Speech API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Texttospeech service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Texttospeech service in particular.) For reference information on specific calls in the Cloud Text-to-Speech API, see the {Google::Apis::TexttospeechV1::TexttospeechService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-texttospeech_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-texttospeech_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/text-to-speech/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-texttospeech_v1/google-apis-texttospeech_v1.gemspec b/generated/google-apis-texttospeech_v1/google-apis-texttospeech_v1.gemspec index 63f3b2d5a..8c3911920 100644 --- a/generated/google-apis-texttospeech_v1/google-apis-texttospeech_v1.gemspec +++ b/generated/google-apis-texttospeech_v1/google-apis-texttospeech_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TexttospeechV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Text-to-Speech API V1" + gem.summary = "Simple REST client for Cloud Text-to-Speech API V1" gem.description = - "This is the legacy REST client for Cloud Text-to-Speech API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Text-to-Speech API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-texttospeech_v1/lib/google/apis/texttospeech_v1/gem_version.rb b/generated/google-apis-texttospeech_v1/lib/google/apis/texttospeech_v1/gem_version.rb index 208bd18a6..27bacdd05 100644 --- a/generated/google-apis-texttospeech_v1/lib/google/apis/texttospeech_v1/gem_version.rb +++ b/generated/google-apis-texttospeech_v1/lib/google/apis/texttospeech_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200814" diff --git a/generated/google-apis-texttospeech_v1beta1/CHANGELOG.md b/generated/google-apis-texttospeech_v1beta1/CHANGELOG.md index 815e54258..99db7af80 100644 --- a/generated/google-apis-texttospeech_v1beta1/CHANGELOG.md +++ b/generated/google-apis-texttospeech_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-texttospeech_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200921 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-texttospeech_v1beta1/OVERVIEW.md b/generated/google-apis-texttospeech_v1beta1/OVERVIEW.md index dc21e6706..aa32ac5ac 100644 --- a/generated/google-apis-texttospeech_v1beta1/OVERVIEW.md +++ b/generated/google-apis-texttospeech_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Cloud Text-to-Speech API +# Simple REST client for version V1beta1 of the Cloud Text-to-Speech API This is a simple client library for version V1beta1 of the Cloud Text-to-Speech API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Cloud Text-to-Speech * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Texttospeech service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Texttospeech service in particular.) For reference information on specific calls in the Cloud Text-to-Speech API, see the {Google::Apis::TexttospeechV1beta1::TexttospeechService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-texttospeech_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-texttospeech_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/text-to-speech/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-texttospeech_v1beta1/google-apis-texttospeech_v1beta1.gemspec b/generated/google-apis-texttospeech_v1beta1/google-apis-texttospeech_v1beta1.gemspec index 59b5b6c06..d74677d37 100644 --- a/generated/google-apis-texttospeech_v1beta1/google-apis-texttospeech_v1beta1.gemspec +++ b/generated/google-apis-texttospeech_v1beta1/google-apis-texttospeech_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TexttospeechV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Text-to-Speech API V1beta1" + gem.summary = "Simple REST client for Cloud Text-to-Speech API V1beta1" gem.description = - "This is the legacy REST client for Cloud Text-to-Speech API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Text-to-Speech API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-texttospeech_v1beta1/lib/google/apis/texttospeech_v1beta1/gem_version.rb b/generated/google-apis-texttospeech_v1beta1/lib/google/apis/texttospeech_v1beta1/gem_version.rb index b4cb1ee05..f8954f9b4 100644 --- a/generated/google-apis-texttospeech_v1beta1/lib/google/apis/texttospeech_v1beta1/gem_version.rb +++ b/generated/google-apis-texttospeech_v1beta1/lib/google/apis/texttospeech_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200921" diff --git a/generated/google-apis-toolresults_v1beta3/CHANGELOG.md b/generated/google-apis-toolresults_v1beta3/CHANGELOG.md index 972abea34..af7e74ee7 100644 --- a/generated/google-apis-toolresults_v1beta3/CHANGELOG.md +++ b/generated/google-apis-toolresults_v1beta3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-toolresults_v1beta3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201029 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-toolresults_v1beta3/OVERVIEW.md b/generated/google-apis-toolresults_v1beta3/OVERVIEW.md index ebdd941a3..596addb08 100644 --- a/generated/google-apis-toolresults_v1beta3/OVERVIEW.md +++ b/generated/google-apis-toolresults_v1beta3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta3 of the Cloud Tool Results API +# Simple REST client for version V1beta3 of the Cloud Tool Results API This is a simple client library for version V1beta3 of the Cloud Tool Results API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta3 of the Cloud Tool Results AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Toolresults service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Toolresults service in particular.) For reference information on specific calls in the Cloud Tool Results API, see the {Google::Apis::ToolresultsV1beta3::ToolResultsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-toolresults_v1beta3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-toolresults_v1beta3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://firebase.google.com/docs/test-lab/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-toolresults_v1beta3/google-apis-toolresults_v1beta3.gemspec b/generated/google-apis-toolresults_v1beta3/google-apis-toolresults_v1beta3.gemspec index ac17de1ff..0d5ed3792 100644 --- a/generated/google-apis-toolresults_v1beta3/google-apis-toolresults_v1beta3.gemspec +++ b/generated/google-apis-toolresults_v1beta3/google-apis-toolresults_v1beta3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::ToolresultsV1beta3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Tool Results API V1beta3" + gem.summary = "Simple REST client for Cloud Tool Results API V1beta3" gem.description = - "This is the legacy REST client for Cloud Tool Results API V1beta3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Tool Results API V1beta3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-toolresults_v1beta3/lib/google/apis/toolresults_v1beta3/gem_version.rb b/generated/google-apis-toolresults_v1beta3/lib/google/apis/toolresults_v1beta3/gem_version.rb index 14bd40724..6723f7f66 100644 --- a/generated/google-apis-toolresults_v1beta3/lib/google/apis/toolresults_v1beta3/gem_version.rb +++ b/generated/google-apis-toolresults_v1beta3/lib/google/apis/toolresults_v1beta3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201029" diff --git a/generated/google-apis-tpu_v1/CHANGELOG.md b/generated/google-apis-tpu_v1/CHANGELOG.md index 7993e5cb1..2193d8d24 100644 --- a/generated/google-apis-tpu_v1/CHANGELOG.md +++ b/generated/google-apis-tpu_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-tpu_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201014 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-tpu_v1/OVERVIEW.md b/generated/google-apis-tpu_v1/OVERVIEW.md index cf2fb42ba..f403d147e 100644 --- a/generated/google-apis-tpu_v1/OVERVIEW.md +++ b/generated/google-apis-tpu_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud TPU API +# Simple REST client for version V1 of the Cloud TPU API This is a simple client library for version V1 of the Cloud TPU API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud TPU API. It provides * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Tpu service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Tpu service in particular.) For reference information on specific calls in the Cloud TPU API, see the {Google::Apis::TpuV1::TPUService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-tpu_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-tpu_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/tpu/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-tpu_v1/google-apis-tpu_v1.gemspec b/generated/google-apis-tpu_v1/google-apis-tpu_v1.gemspec index f9b26b348..a4c691213 100644 --- a/generated/google-apis-tpu_v1/google-apis-tpu_v1.gemspec +++ b/generated/google-apis-tpu_v1/google-apis-tpu_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TpuV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud TPU API V1" + gem.summary = "Simple REST client for Cloud TPU API V1" gem.description = - "This is the legacy REST client for Cloud TPU API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud TPU API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-tpu_v1/lib/google/apis/tpu_v1/gem_version.rb b/generated/google-apis-tpu_v1/lib/google/apis/tpu_v1/gem_version.rb index 986fcc219..a831be37f 100644 --- a/generated/google-apis-tpu_v1/lib/google/apis/tpu_v1/gem_version.rb +++ b/generated/google-apis-tpu_v1/lib/google/apis/tpu_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201014" diff --git a/generated/google-apis-tpu_v1alpha1/CHANGELOG.md b/generated/google-apis-tpu_v1alpha1/CHANGELOG.md index f25272630..5fd57f718 100644 --- a/generated/google-apis-tpu_v1alpha1/CHANGELOG.md +++ b/generated/google-apis-tpu_v1alpha1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-tpu_v1alpha1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201014 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-tpu_v1alpha1/OVERVIEW.md b/generated/google-apis-tpu_v1alpha1/OVERVIEW.md index 46a9be6d2..71d2ca5e5 100644 --- a/generated/google-apis-tpu_v1alpha1/OVERVIEW.md +++ b/generated/google-apis-tpu_v1alpha1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha1 of the Cloud TPU API +# Simple REST client for version V1alpha1 of the Cloud TPU API This is a simple client library for version V1alpha1 of the Cloud TPU API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha1 of the Cloud TPU API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Tpu service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Tpu service in particular.) For reference information on specific calls in the Cloud TPU API, see the {Google::Apis::TpuV1alpha1::TPUService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-tpu_v1alpha1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-tpu_v1alpha1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/tpu/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-tpu_v1alpha1/google-apis-tpu_v1alpha1.gemspec b/generated/google-apis-tpu_v1alpha1/google-apis-tpu_v1alpha1.gemspec index 62bf8bad1..f15567dc5 100644 --- a/generated/google-apis-tpu_v1alpha1/google-apis-tpu_v1alpha1.gemspec +++ b/generated/google-apis-tpu_v1alpha1/google-apis-tpu_v1alpha1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TpuV1alpha1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud TPU API V1alpha1" + gem.summary = "Simple REST client for Cloud TPU API V1alpha1" gem.description = - "This is the legacy REST client for Cloud TPU API V1alpha1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud TPU API V1alpha1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-tpu_v1alpha1/lib/google/apis/tpu_v1alpha1/gem_version.rb b/generated/google-apis-tpu_v1alpha1/lib/google/apis/tpu_v1alpha1/gem_version.rb index ca9f4ae2f..4cb5a6205 100644 --- a/generated/google-apis-tpu_v1alpha1/lib/google/apis/tpu_v1alpha1/gem_version.rb +++ b/generated/google-apis-tpu_v1alpha1/lib/google/apis/tpu_v1alpha1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201014" diff --git a/generated/google-apis-trafficdirector_v2/CHANGELOG.md b/generated/google-apis-trafficdirector_v2/CHANGELOG.md index f8eb8ef07..2d17c071d 100644 --- a/generated/google-apis-trafficdirector_v2/CHANGELOG.md +++ b/generated/google-apis-trafficdirector_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-trafficdirector_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201123 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-trafficdirector_v2/OVERVIEW.md b/generated/google-apis-trafficdirector_v2/OVERVIEW.md index 466facaef..6843ca9e8 100644 --- a/generated/google-apis-trafficdirector_v2/OVERVIEW.md +++ b/generated/google-apis-trafficdirector_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Traffic Director API +# Simple REST client for version V2 of the Traffic Director API This is a simple client library for version V2 of the Traffic Director API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Traffic Director API. It p * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Trafficdirector service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Trafficdirector service in particular.) For reference information on specific calls in the Traffic Director API, see the {Google::Apis::TrafficdirectorV2::TrafficDirectorServiceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-trafficdirector_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-trafficdirector_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/traffic-director) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-trafficdirector_v2/google-apis-trafficdirector_v2.gemspec b/generated/google-apis-trafficdirector_v2/google-apis-trafficdirector_v2.gemspec index db3810bb4..758b3bfe8 100644 --- a/generated/google-apis-trafficdirector_v2/google-apis-trafficdirector_v2.gemspec +++ b/generated/google-apis-trafficdirector_v2/google-apis-trafficdirector_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TrafficdirectorV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Traffic Director API V2" + gem.summary = "Simple REST client for Traffic Director API V2" gem.description = - "This is the legacy REST client for Traffic Director API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Traffic Director API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-trafficdirector_v2/lib/google/apis/trafficdirector_v2/gem_version.rb b/generated/google-apis-trafficdirector_v2/lib/google/apis/trafficdirector_v2/gem_version.rb index 7312af51b..6996f4d5d 100644 --- a/generated/google-apis-trafficdirector_v2/lib/google/apis/trafficdirector_v2/gem_version.rb +++ b/generated/google-apis-trafficdirector_v2/lib/google/apis/trafficdirector_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201123" diff --git a/generated/google-apis-transcoder_v1beta1/CHANGELOG.md b/generated/google-apis-transcoder_v1beta1/CHANGELOG.md index e3216e6fa..8553acac8 100644 --- a/generated/google-apis-transcoder_v1beta1/CHANGELOG.md +++ b/generated/google-apis-transcoder_v1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-transcoder_v1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201209 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-transcoder_v1beta1/OVERVIEW.md b/generated/google-apis-transcoder_v1beta1/OVERVIEW.md index c31785a1b..6f2e4aec2 100644 --- a/generated/google-apis-transcoder_v1beta1/OVERVIEW.md +++ b/generated/google-apis-transcoder_v1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta1 of the Transcoder API +# Simple REST client for version V1beta1 of the Transcoder API This is a simple client library for version V1beta1 of the Transcoder API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta1 of the Transcoder API. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Transcoder service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Transcoder service in particular.) For reference information on specific calls in the Transcoder API, see the {Google::Apis::TranscoderV1beta1::TranscoderService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-transcoder_v1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-transcoder_v1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/transcoder/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-transcoder_v1beta1/google-apis-transcoder_v1beta1.gemspec b/generated/google-apis-transcoder_v1beta1/google-apis-transcoder_v1beta1.gemspec index b468628c3..77dd48d0d 100644 --- a/generated/google-apis-transcoder_v1beta1/google-apis-transcoder_v1beta1.gemspec +++ b/generated/google-apis-transcoder_v1beta1/google-apis-transcoder_v1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TranscoderV1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Transcoder API V1beta1" + gem.summary = "Simple REST client for Transcoder API V1beta1" gem.description = - "This is the legacy REST client for Transcoder API V1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Transcoder API V1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-transcoder_v1beta1/lib/google/apis/transcoder_v1beta1/gem_version.rb b/generated/google-apis-transcoder_v1beta1/lib/google/apis/transcoder_v1beta1/gem_version.rb index e07cab763..77c2e19e0 100644 --- a/generated/google-apis-transcoder_v1beta1/lib/google/apis/transcoder_v1beta1/gem_version.rb +++ b/generated/google-apis-transcoder_v1beta1/lib/google/apis/transcoder_v1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201209" diff --git a/generated/google-apis-translate_v2/CHANGELOG.md b/generated/google-apis-translate_v2/CHANGELOG.md index b048eee24..ee78d7fc7 100644 --- a/generated/google-apis-translate_v2/CHANGELOG.md +++ b/generated/google-apis-translate_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-translate_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20170525 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-translate_v2/OVERVIEW.md b/generated/google-apis-translate_v2/OVERVIEW.md index dfd1ab155..12b8ace7d 100644 --- a/generated/google-apis-translate_v2/OVERVIEW.md +++ b/generated/google-apis-translate_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the Google Cloud Translation API +# Simple REST client for version V2 of the Google Cloud Translation API This is a simple client library for version V2 of the Google Cloud Translation API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the Google Cloud Translation A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Translate service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Translate service in particular.) For reference information on specific calls in the Google Cloud Translation API, see the {Google::Apis::TranslateV2::TranslateService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-translate_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-translate_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://code.google.com/apis/language/translate/v2/getting_started.html) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-translate_v2/google-apis-translate_v2.gemspec b/generated/google-apis-translate_v2/google-apis-translate_v2.gemspec index c201bc37e..06d8a8d0b 100644 --- a/generated/google-apis-translate_v2/google-apis-translate_v2.gemspec +++ b/generated/google-apis-translate_v2/google-apis-translate_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TranslateV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Google Cloud Translation API V2" + gem.summary = "Simple REST client for Google Cloud Translation API V2" gem.description = - "This is the legacy REST client for Google Cloud Translation API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Google Cloud Translation API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-translate_v2/lib/google/apis/translate_v2/gem_version.rb b/generated/google-apis-translate_v2/lib/google/apis/translate_v2/gem_version.rb index 31944fe1d..7edf81428 100644 --- a/generated/google-apis-translate_v2/lib/google/apis/translate_v2/gem_version.rb +++ b/generated/google-apis-translate_v2/lib/google/apis/translate_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20170525" diff --git a/generated/google-apis-translate_v3/CHANGELOG.md b/generated/google-apis-translate_v3/CHANGELOG.md index 9cd53bf53..46838355f 100644 --- a/generated/google-apis-translate_v3/CHANGELOG.md +++ b/generated/google-apis-translate_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-translate_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-translate_v3/OVERVIEW.md b/generated/google-apis-translate_v3/OVERVIEW.md index 11f815d4b..dac5b2484 100644 --- a/generated/google-apis-translate_v3/OVERVIEW.md +++ b/generated/google-apis-translate_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Cloud Translation API +# Simple REST client for version V3 of the Cloud Translation API This is a simple client library for version V3 of the Cloud Translation API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Cloud Translation API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Translate service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Translate service in particular.) For reference information on specific calls in the Cloud Translation API, see the {Google::Apis::TranslateV3::TranslateService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-translate_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-translate_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/translate/docs/quickstarts) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-translate_v3/google-apis-translate_v3.gemspec b/generated/google-apis-translate_v3/google-apis-translate_v3.gemspec index 8c9155557..ff66fd3d9 100644 --- a/generated/google-apis-translate_v3/google-apis-translate_v3.gemspec +++ b/generated/google-apis-translate_v3/google-apis-translate_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TranslateV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Translation API V3" + gem.summary = "Simple REST client for Cloud Translation API V3" gem.description = - "This is the legacy REST client for Cloud Translation API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Translation API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-translate_v3/lib/google/apis/translate_v3/gem_version.rb b/generated/google-apis-translate_v3/lib/google/apis/translate_v3/gem_version.rb index e372d6929..b528ea9b2 100644 --- a/generated/google-apis-translate_v3/lib/google/apis/translate_v3/gem_version.rb +++ b/generated/google-apis-translate_v3/lib/google/apis/translate_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-translate_v3beta1/CHANGELOG.md b/generated/google-apis-translate_v3beta1/CHANGELOG.md index 5f87d69c0..40fd50362 100644 --- a/generated/google-apis-translate_v3beta1/CHANGELOG.md +++ b/generated/google-apis-translate_v3beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-translate_v3beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-translate_v3beta1/OVERVIEW.md b/generated/google-apis-translate_v3beta1/OVERVIEW.md index 8815b7124..c0d76fbd4 100644 --- a/generated/google-apis-translate_v3beta1/OVERVIEW.md +++ b/generated/google-apis-translate_v3beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3beta1 of the Cloud Translation API +# Simple REST client for version V3beta1 of the Cloud Translation API This is a simple client library for version V3beta1 of the Cloud Translation API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3beta1 of the Cloud Translation API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Translate service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Translate service in particular.) For reference information on specific calls in the Cloud Translation API, see the {Google::Apis::TranslateV3beta1::TranslateService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-translate_v3beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-translate_v3beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/translate/docs/quickstarts) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-translate_v3beta1/google-apis-translate_v3beta1.gemspec b/generated/google-apis-translate_v3beta1/google-apis-translate_v3beta1.gemspec index 845731367..c1607c5b6 100644 --- a/generated/google-apis-translate_v3beta1/google-apis-translate_v3beta1.gemspec +++ b/generated/google-apis-translate_v3beta1/google-apis-translate_v3beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::TranslateV3beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Translation API V3beta1" + gem.summary = "Simple REST client for Cloud Translation API V3beta1" gem.description = - "This is the legacy REST client for Cloud Translation API V3beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Translation API V3beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-translate_v3beta1/lib/google/apis/translate_v3beta1/gem_version.rb b/generated/google-apis-translate_v3beta1/lib/google/apis/translate_v3beta1/gem_version.rb index fd7022f04..f22f316e7 100644 --- a/generated/google-apis-translate_v3beta1/lib/google/apis/translate_v3beta1/gem_version.rb +++ b/generated/google-apis-translate_v3beta1/lib/google/apis/translate_v3beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-vault_v1/CHANGELOG.md b/generated/google-apis-vault_v1/CHANGELOG.md index 2ff70adc2..1d03169b9 100644 --- a/generated/google-apis-vault_v1/CHANGELOG.md +++ b/generated/google-apis-vault_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-vault_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201117 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-vault_v1/OVERVIEW.md b/generated/google-apis-vault_v1/OVERVIEW.md index 4fa58c5d9..e58a44ce7 100644 --- a/generated/google-apis-vault_v1/OVERVIEW.md +++ b/generated/google-apis-vault_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the G Suite Vault API +# Simple REST client for version V1 of the G Suite Vault API This is a simple client library for version V1 of the G Suite Vault API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the G Suite Vault API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Vault service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vault service in particular.) For reference information on specific calls in the G Suite Vault API, see the {Google::Apis::VaultV1::VaultService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-vault_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-vault_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/vault) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-vault_v1/google-apis-vault_v1.gemspec b/generated/google-apis-vault_v1/google-apis-vault_v1.gemspec index 7844bcbde..3d10df3f2 100644 --- a/generated/google-apis-vault_v1/google-apis-vault_v1.gemspec +++ b/generated/google-apis-vault_v1/google-apis-vault_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VaultV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for G Suite Vault API V1" + gem.summary = "Simple REST client for G Suite Vault API V1" gem.description = - "This is the legacy REST client for G Suite Vault API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for G Suite Vault API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-vault_v1/lib/google/apis/vault_v1/gem_version.rb b/generated/google-apis-vault_v1/lib/google/apis/vault_v1/gem_version.rb index 3e78a389d..5cb9c8a4f 100644 --- a/generated/google-apis-vault_v1/lib/google/apis/vault_v1/gem_version.rb +++ b/generated/google-apis-vault_v1/lib/google/apis/vault_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201117" diff --git a/generated/google-apis-vectortile_v1/CHANGELOG.md b/generated/google-apis-vectortile_v1/CHANGELOG.md index 7b677ad05..ea2c0c823 100644 --- a/generated/google-apis-vectortile_v1/CHANGELOG.md +++ b/generated/google-apis-vectortile_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-vectortile_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201202 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-vectortile_v1/OVERVIEW.md b/generated/google-apis-vectortile_v1/OVERVIEW.md index adbac634b..43f457c86 100644 --- a/generated/google-apis-vectortile_v1/OVERVIEW.md +++ b/generated/google-apis-vectortile_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Semantic Tile API +# Simple REST client for version V1 of the Semantic Tile API This is a simple client library for version V1 of the Semantic Tile API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Semantic Tile API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Vectortile service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vectortile service in particular.) For reference information on specific calls in the Semantic Tile API, see the {Google::Apis::VectortileV1::SemanticTileService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-vectortile_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-vectortile_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/maps/contact-sales/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-vectortile_v1/google-apis-vectortile_v1.gemspec b/generated/google-apis-vectortile_v1/google-apis-vectortile_v1.gemspec index 031368a71..37b6bcae2 100644 --- a/generated/google-apis-vectortile_v1/google-apis-vectortile_v1.gemspec +++ b/generated/google-apis-vectortile_v1/google-apis-vectortile_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VectortileV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Semantic Tile API V1" + gem.summary = "Simple REST client for Semantic Tile API V1" gem.description = - "This is the legacy REST client for Semantic Tile API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Semantic Tile API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-vectortile_v1/lib/google/apis/vectortile_v1/gem_version.rb b/generated/google-apis-vectortile_v1/lib/google/apis/vectortile_v1/gem_version.rb index 60adb542c..24a8a2728 100644 --- a/generated/google-apis-vectortile_v1/lib/google/apis/vectortile_v1/gem_version.rb +++ b/generated/google-apis-vectortile_v1/lib/google/apis/vectortile_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201202" diff --git a/generated/google-apis-verifiedaccess_v1/CHANGELOG.md b/generated/google-apis-verifiedaccess_v1/CHANGELOG.md index c1231bc0c..18b2955cb 100644 --- a/generated/google-apis-verifiedaccess_v1/CHANGELOG.md +++ b/generated/google-apis-verifiedaccess_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-verifiedaccess_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200828 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-verifiedaccess_v1/OVERVIEW.md b/generated/google-apis-verifiedaccess_v1/OVERVIEW.md index 2462f9aae..becfda70c 100644 --- a/generated/google-apis-verifiedaccess_v1/OVERVIEW.md +++ b/generated/google-apis-verifiedaccess_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Chrome Verified Access API +# Simple REST client for version V1 of the Chrome Verified Access API This is a simple client library for version V1 of the Chrome Verified Access API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Chrome Verified Access API * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Verifiedaccess service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Verifiedaccess service in particular.) For reference information on specific calls in the Chrome Verified Access API, see the {Google::Apis::VerifiedaccessV1::VerifiedaccessService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-verifiedaccess_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-verifiedaccess_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/chrome/verified-access) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-verifiedaccess_v1/google-apis-verifiedaccess_v1.gemspec b/generated/google-apis-verifiedaccess_v1/google-apis-verifiedaccess_v1.gemspec index 329d4f7e7..aef448918 100644 --- a/generated/google-apis-verifiedaccess_v1/google-apis-verifiedaccess_v1.gemspec +++ b/generated/google-apis-verifiedaccess_v1/google-apis-verifiedaccess_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VerifiedaccessV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Chrome Verified Access API V1" + gem.summary = "Simple REST client for Chrome Verified Access API V1" gem.description = - "This is the legacy REST client for Chrome Verified Access API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Chrome Verified Access API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-verifiedaccess_v1/lib/google/apis/verifiedaccess_v1/gem_version.rb b/generated/google-apis-verifiedaccess_v1/lib/google/apis/verifiedaccess_v1/gem_version.rb index 95e4375a6..2e5150282 100644 --- a/generated/google-apis-verifiedaccess_v1/lib/google/apis/verifiedaccess_v1/gem_version.rb +++ b/generated/google-apis-verifiedaccess_v1/lib/google/apis/verifiedaccess_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200828" diff --git a/generated/google-apis-videointelligence_v1/CHANGELOG.md b/generated/google-apis-videointelligence_v1/CHANGELOG.md index cc92a2c5a..0c010aba5 100644 --- a/generated/google-apis-videointelligence_v1/CHANGELOG.md +++ b/generated/google-apis-videointelligence_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-videointelligence_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-videointelligence_v1/OVERVIEW.md b/generated/google-apis-videointelligence_v1/OVERVIEW.md index d90ae208c..90b03bef3 100644 --- a/generated/google-apis-videointelligence_v1/OVERVIEW.md +++ b/generated/google-apis-videointelligence_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Video Intelligence API +# Simple REST client for version V1 of the Cloud Video Intelligence API This is a simple client library for version V1 of the Cloud Video Intelligence API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Video Intelligence A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Videointelligence service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Videointelligence service in particular.) For reference information on specific calls in the Cloud Video Intelligence API, see the {Google::Apis::VideointelligenceV1::CloudVideoIntelligenceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-videointelligence_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-videointelligence_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/video-intelligence/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-videointelligence_v1/google-apis-videointelligence_v1.gemspec b/generated/google-apis-videointelligence_v1/google-apis-videointelligence_v1.gemspec index b6baf2697..06c0f78c2 100644 --- a/generated/google-apis-videointelligence_v1/google-apis-videointelligence_v1.gemspec +++ b/generated/google-apis-videointelligence_v1/google-apis-videointelligence_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VideointelligenceV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Video Intelligence API V1" + gem.summary = "Simple REST client for Cloud Video Intelligence API V1" gem.description = - "This is the legacy REST client for Cloud Video Intelligence API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Video Intelligence API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-videointelligence_v1/lib/google/apis/videointelligence_v1/gem_version.rb b/generated/google-apis-videointelligence_v1/lib/google/apis/videointelligence_v1/gem_version.rb index 8368d4e8c..a8cad63f6 100644 --- a/generated/google-apis-videointelligence_v1/lib/google/apis/videointelligence_v1/gem_version.rb +++ b/generated/google-apis-videointelligence_v1/lib/google/apis/videointelligence_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-videointelligence_v1beta2/CHANGELOG.md b/generated/google-apis-videointelligence_v1beta2/CHANGELOG.md index 785da7833..69ec70cf4 100644 --- a/generated/google-apis-videointelligence_v1beta2/CHANGELOG.md +++ b/generated/google-apis-videointelligence_v1beta2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-videointelligence_v1beta2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-videointelligence_v1beta2/OVERVIEW.md b/generated/google-apis-videointelligence_v1beta2/OVERVIEW.md index 14ebac046..9d9047dfb 100644 --- a/generated/google-apis-videointelligence_v1beta2/OVERVIEW.md +++ b/generated/google-apis-videointelligence_v1beta2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta2 of the Cloud Video Intelligence API +# Simple REST client for version V1beta2 of the Cloud Video Intelligence API This is a simple client library for version V1beta2 of the Cloud Video Intelligence API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta2 of the Cloud Video Intellige * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Videointelligence service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Videointelligence service in particular.) For reference information on specific calls in the Cloud Video Intelligence API, see the {Google::Apis::VideointelligenceV1beta2::CloudVideoIntelligenceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-videointelligence_v1beta2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-videointelligence_v1beta2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/video-intelligence/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-videointelligence_v1beta2/google-apis-videointelligence_v1beta2.gemspec b/generated/google-apis-videointelligence_v1beta2/google-apis-videointelligence_v1beta2.gemspec index d7be3eab2..f4683d1c5 100644 --- a/generated/google-apis-videointelligence_v1beta2/google-apis-videointelligence_v1beta2.gemspec +++ b/generated/google-apis-videointelligence_v1beta2/google-apis-videointelligence_v1beta2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VideointelligenceV1beta2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Video Intelligence API V1beta2" + gem.summary = "Simple REST client for Cloud Video Intelligence API V1beta2" gem.description = - "This is the legacy REST client for Cloud Video Intelligence API V1beta2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Video Intelligence API V1beta2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-videointelligence_v1beta2/lib/google/apis/videointelligence_v1beta2/gem_version.rb b/generated/google-apis-videointelligence_v1beta2/lib/google/apis/videointelligence_v1beta2/gem_version.rb index b95caf64e..f51ff95d8 100644 --- a/generated/google-apis-videointelligence_v1beta2/lib/google/apis/videointelligence_v1beta2/gem_version.rb +++ b/generated/google-apis-videointelligence_v1beta2/lib/google/apis/videointelligence_v1beta2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-videointelligence_v1p1beta1/CHANGELOG.md b/generated/google-apis-videointelligence_v1p1beta1/CHANGELOG.md index 5faaf3adc..4e9663576 100644 --- a/generated/google-apis-videointelligence_v1p1beta1/CHANGELOG.md +++ b/generated/google-apis-videointelligence_v1p1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-videointelligence_v1p1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-videointelligence_v1p1beta1/OVERVIEW.md b/generated/google-apis-videointelligence_v1p1beta1/OVERVIEW.md index 813240766..e9fcbc740 100644 --- a/generated/google-apis-videointelligence_v1p1beta1/OVERVIEW.md +++ b/generated/google-apis-videointelligence_v1p1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p1beta1 of the Cloud Video Intelligence API +# Simple REST client for version V1p1beta1 of the Cloud Video Intelligence API This is a simple client library for version V1p1beta1 of the Cloud Video Intelligence API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p1beta1 of the Cloud Video Intelli * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Videointelligence service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Videointelligence service in particular.) For reference information on specific calls in the Cloud Video Intelligence API, see the {Google::Apis::VideointelligenceV1p1beta1::CloudVideoIntelligenceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-videointelligence_v1p1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-videointelligence_v1p1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/video-intelligence/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-videointelligence_v1p1beta1/google-apis-videointelligence_v1p1beta1.gemspec b/generated/google-apis-videointelligence_v1p1beta1/google-apis-videointelligence_v1p1beta1.gemspec index ec8a3faaf..5a05919dc 100644 --- a/generated/google-apis-videointelligence_v1p1beta1/google-apis-videointelligence_v1p1beta1.gemspec +++ b/generated/google-apis-videointelligence_v1p1beta1/google-apis-videointelligence_v1p1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VideointelligenceV1p1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Video Intelligence API V1p1beta1" + gem.summary = "Simple REST client for Cloud Video Intelligence API V1p1beta1" gem.description = - "This is the legacy REST client for Cloud Video Intelligence API V1p1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Video Intelligence API V1p1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-videointelligence_v1p1beta1/lib/google/apis/videointelligence_v1p1beta1/gem_version.rb b/generated/google-apis-videointelligence_v1p1beta1/lib/google/apis/videointelligence_v1p1beta1/gem_version.rb index 0b3a1dbd3..fbc62d1ad 100644 --- a/generated/google-apis-videointelligence_v1p1beta1/lib/google/apis/videointelligence_v1p1beta1/gem_version.rb +++ b/generated/google-apis-videointelligence_v1p1beta1/lib/google/apis/videointelligence_v1p1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-videointelligence_v1p2beta1/CHANGELOG.md b/generated/google-apis-videointelligence_v1p2beta1/CHANGELOG.md index 900bb22c6..e11b2c2b2 100644 --- a/generated/google-apis-videointelligence_v1p2beta1/CHANGELOG.md +++ b/generated/google-apis-videointelligence_v1p2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-videointelligence_v1p2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-videointelligence_v1p2beta1/OVERVIEW.md b/generated/google-apis-videointelligence_v1p2beta1/OVERVIEW.md index a1f1fcdd1..4775a8e96 100644 --- a/generated/google-apis-videointelligence_v1p2beta1/OVERVIEW.md +++ b/generated/google-apis-videointelligence_v1p2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p2beta1 of the Cloud Video Intelligence API +# Simple REST client for version V1p2beta1 of the Cloud Video Intelligence API This is a simple client library for version V1p2beta1 of the Cloud Video Intelligence API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p2beta1 of the Cloud Video Intelli * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Videointelligence service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Videointelligence service in particular.) For reference information on specific calls in the Cloud Video Intelligence API, see the {Google::Apis::VideointelligenceV1p2beta1::CloudVideoIntelligenceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-videointelligence_v1p2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-videointelligence_v1p2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/video-intelligence/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-videointelligence_v1p2beta1/google-apis-videointelligence_v1p2beta1.gemspec b/generated/google-apis-videointelligence_v1p2beta1/google-apis-videointelligence_v1p2beta1.gemspec index 3411747e0..efde72687 100644 --- a/generated/google-apis-videointelligence_v1p2beta1/google-apis-videointelligence_v1p2beta1.gemspec +++ b/generated/google-apis-videointelligence_v1p2beta1/google-apis-videointelligence_v1p2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VideointelligenceV1p2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Video Intelligence API V1p2beta1" + gem.summary = "Simple REST client for Cloud Video Intelligence API V1p2beta1" gem.description = - "This is the legacy REST client for Cloud Video Intelligence API V1p2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Video Intelligence API V1p2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-videointelligence_v1p2beta1/lib/google/apis/videointelligence_v1p2beta1/gem_version.rb b/generated/google-apis-videointelligence_v1p2beta1/lib/google/apis/videointelligence_v1p2beta1/gem_version.rb index 51f8d9356..c41d2494e 100644 --- a/generated/google-apis-videointelligence_v1p2beta1/lib/google/apis/videointelligence_v1p2beta1/gem_version.rb +++ b/generated/google-apis-videointelligence_v1p2beta1/lib/google/apis/videointelligence_v1p2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-videointelligence_v1p3beta1/CHANGELOG.md b/generated/google-apis-videointelligence_v1p3beta1/CHANGELOG.md index a57a7d315..45fd44b37 100644 --- a/generated/google-apis-videointelligence_v1p3beta1/CHANGELOG.md +++ b/generated/google-apis-videointelligence_v1p3beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-videointelligence_v1p3beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201204 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-videointelligence_v1p3beta1/OVERVIEW.md b/generated/google-apis-videointelligence_v1p3beta1/OVERVIEW.md index c905c33d2..8806c90a0 100644 --- a/generated/google-apis-videointelligence_v1p3beta1/OVERVIEW.md +++ b/generated/google-apis-videointelligence_v1p3beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p3beta1 of the Cloud Video Intelligence API +# Simple REST client for version V1p3beta1 of the Cloud Video Intelligence API This is a simple client library for version V1p3beta1 of the Cloud Video Intelligence API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p3beta1 of the Cloud Video Intelli * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Videointelligence service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Videointelligence service in particular.) For reference information on specific calls in the Cloud Video Intelligence API, see the {Google::Apis::VideointelligenceV1p3beta1::CloudVideoIntelligenceService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-videointelligence_v1p3beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-videointelligence_v1p3beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/video-intelligence/docs/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-videointelligence_v1p3beta1/google-apis-videointelligence_v1p3beta1.gemspec b/generated/google-apis-videointelligence_v1p3beta1/google-apis-videointelligence_v1p3beta1.gemspec index 1689391dc..d36e3aad9 100644 --- a/generated/google-apis-videointelligence_v1p3beta1/google-apis-videointelligence_v1p3beta1.gemspec +++ b/generated/google-apis-videointelligence_v1p3beta1/google-apis-videointelligence_v1p3beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VideointelligenceV1p3beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Video Intelligence API V1p3beta1" + gem.summary = "Simple REST client for Cloud Video Intelligence API V1p3beta1" gem.description = - "This is the legacy REST client for Cloud Video Intelligence API V1p3beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Video Intelligence API V1p3beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-videointelligence_v1p3beta1/lib/google/apis/videointelligence_v1p3beta1/gem_version.rb b/generated/google-apis-videointelligence_v1p3beta1/lib/google/apis/videointelligence_v1p3beta1/gem_version.rb index df83dfa62..eb7cf44ea 100644 --- a/generated/google-apis-videointelligence_v1p3beta1/lib/google/apis/videointelligence_v1p3beta1/gem_version.rb +++ b/generated/google-apis-videointelligence_v1p3beta1/lib/google/apis/videointelligence_v1p3beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201204" diff --git a/generated/google-apis-vision_v1/CHANGELOG.md b/generated/google-apis-vision_v1/CHANGELOG.md index 3fae4e0ea..5bad562bd 100644 --- a/generated/google-apis-vision_v1/CHANGELOG.md +++ b/generated/google-apis-vision_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-vision_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201023 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-vision_v1/OVERVIEW.md b/generated/google-apis-vision_v1/OVERVIEW.md index 6bfb2f529..afb7faaf3 100644 --- a/generated/google-apis-vision_v1/OVERVIEW.md +++ b/generated/google-apis-vision_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Cloud Vision API +# Simple REST client for version V1 of the Cloud Vision API This is a simple client library for version V1 of the Cloud Vision API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Cloud Vision API. It provi * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Vision service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vision service in particular.) For reference information on specific calls in the Cloud Vision API, see the {Google::Apis::VisionV1::VisionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-vision_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-vision_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/vision/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-vision_v1/google-apis-vision_v1.gemspec b/generated/google-apis-vision_v1/google-apis-vision_v1.gemspec index 20f122070..d1134db57 100644 --- a/generated/google-apis-vision_v1/google-apis-vision_v1.gemspec +++ b/generated/google-apis-vision_v1/google-apis-vision_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VisionV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Vision API V1" + gem.summary = "Simple REST client for Cloud Vision API V1" gem.description = - "This is the legacy REST client for Cloud Vision API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Vision API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-vision_v1/lib/google/apis/vision_v1/gem_version.rb b/generated/google-apis-vision_v1/lib/google/apis/vision_v1/gem_version.rb index 0605cf72c..835e34aba 100644 --- a/generated/google-apis-vision_v1/lib/google/apis/vision_v1/gem_version.rb +++ b/generated/google-apis-vision_v1/lib/google/apis/vision_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201023" diff --git a/generated/google-apis-vision_v1p1beta1/CHANGELOG.md b/generated/google-apis-vision_v1p1beta1/CHANGELOG.md index 44af8d839..7b4d7499c 100644 --- a/generated/google-apis-vision_v1p1beta1/CHANGELOG.md +++ b/generated/google-apis-vision_v1p1beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-vision_v1p1beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201023 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-vision_v1p1beta1/OVERVIEW.md b/generated/google-apis-vision_v1p1beta1/OVERVIEW.md index d3ac658cc..a9fea87e7 100644 --- a/generated/google-apis-vision_v1p1beta1/OVERVIEW.md +++ b/generated/google-apis-vision_v1p1beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p1beta1 of the Cloud Vision API +# Simple REST client for version V1p1beta1 of the Cloud Vision API This is a simple client library for version V1p1beta1 of the Cloud Vision API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p1beta1 of the Cloud Vision API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Vision service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vision service in particular.) For reference information on specific calls in the Cloud Vision API, see the {Google::Apis::VisionV1p1beta1::VisionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-vision_v1p1beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-vision_v1p1beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/vision/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-vision_v1p1beta1/google-apis-vision_v1p1beta1.gemspec b/generated/google-apis-vision_v1p1beta1/google-apis-vision_v1p1beta1.gemspec index 22a4e4e8b..b062e5fe4 100644 --- a/generated/google-apis-vision_v1p1beta1/google-apis-vision_v1p1beta1.gemspec +++ b/generated/google-apis-vision_v1p1beta1/google-apis-vision_v1p1beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VisionV1p1beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Vision API V1p1beta1" + gem.summary = "Simple REST client for Cloud Vision API V1p1beta1" gem.description = - "This is the legacy REST client for Cloud Vision API V1p1beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Vision API V1p1beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-vision_v1p1beta1/lib/google/apis/vision_v1p1beta1/gem_version.rb b/generated/google-apis-vision_v1p1beta1/lib/google/apis/vision_v1p1beta1/gem_version.rb index c4380654d..619f7929a 100644 --- a/generated/google-apis-vision_v1p1beta1/lib/google/apis/vision_v1p1beta1/gem_version.rb +++ b/generated/google-apis-vision_v1p1beta1/lib/google/apis/vision_v1p1beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201023" diff --git a/generated/google-apis-vision_v1p2beta1/CHANGELOG.md b/generated/google-apis-vision_v1p2beta1/CHANGELOG.md index 8a61c81ac..a64b27187 100644 --- a/generated/google-apis-vision_v1p2beta1/CHANGELOG.md +++ b/generated/google-apis-vision_v1p2beta1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-vision_v1p2beta1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201023 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-vision_v1p2beta1/OVERVIEW.md b/generated/google-apis-vision_v1p2beta1/OVERVIEW.md index 1b4be4cbe..d665b243e 100644 --- a/generated/google-apis-vision_v1p2beta1/OVERVIEW.md +++ b/generated/google-apis-vision_v1p2beta1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1p2beta1 of the Cloud Vision API +# Simple REST client for version V1p2beta1 of the Cloud Vision API This is a simple client library for version V1p2beta1 of the Cloud Vision API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1p2beta1 of the Cloud Vision API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Vision service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vision service in particular.) For reference information on specific calls in the Cloud Vision API, see the {Google::Apis::VisionV1p2beta1::VisionService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-vision_v1p2beta1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-vision_v1p2beta1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/vision/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-vision_v1p2beta1/google-apis-vision_v1p2beta1.gemspec b/generated/google-apis-vision_v1p2beta1/google-apis-vision_v1p2beta1.gemspec index 2d0efa307..542debeea 100644 --- a/generated/google-apis-vision_v1p2beta1/google-apis-vision_v1p2beta1.gemspec +++ b/generated/google-apis-vision_v1p2beta1/google-apis-vision_v1p2beta1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::VisionV1p2beta1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Cloud Vision API V1p2beta1" + gem.summary = "Simple REST client for Cloud Vision API V1p2beta1" gem.description = - "This is the legacy REST client for Cloud Vision API V1p2beta1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Cloud Vision API V1p2beta1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-vision_v1p2beta1/lib/google/apis/vision_v1p2beta1/gem_version.rb b/generated/google-apis-vision_v1p2beta1/lib/google/apis/vision_v1p2beta1/gem_version.rb index c81071dc7..d8bba57b7 100644 --- a/generated/google-apis-vision_v1p2beta1/lib/google/apis/vision_v1p2beta1/gem_version.rb +++ b/generated/google-apis-vision_v1p2beta1/lib/google/apis/vision_v1p2beta1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201023" diff --git a/generated/google-apis-webfonts_v1/CHANGELOG.md b/generated/google-apis-webfonts_v1/CHANGELOG.md index 55b0df423..873132e17 100644 --- a/generated/google-apis-webfonts_v1/CHANGELOG.md +++ b/generated/google-apis-webfonts_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-webfonts_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200819 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-webfonts_v1/OVERVIEW.md b/generated/google-apis-webfonts_v1/OVERVIEW.md index e466bdd2f..b5d8be75c 100644 --- a/generated/google-apis-webfonts_v1/OVERVIEW.md +++ b/generated/google-apis-webfonts_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Web Fonts Developer API +# Simple REST client for version V1 of the Web Fonts Developer API This is a simple client library for version V1 of the Web Fonts Developer API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Web Fonts Developer API. I * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Webfonts service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Webfonts service in particular.) For reference information on specific calls in the Web Fonts Developer API, see the {Google::Apis::WebfontsV1::WebfontsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-webfonts_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-webfonts_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/fonts/docs/developer_api) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-webfonts_v1/google-apis-webfonts_v1.gemspec b/generated/google-apis-webfonts_v1/google-apis-webfonts_v1.gemspec index 35341c4ec..901d368b6 100644 --- a/generated/google-apis-webfonts_v1/google-apis-webfonts_v1.gemspec +++ b/generated/google-apis-webfonts_v1/google-apis-webfonts_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WebfontsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Web Fonts Developer API V1" + gem.summary = "Simple REST client for Web Fonts Developer API V1" gem.description = - "This is the legacy REST client for Web Fonts Developer API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Web Fonts Developer API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-webfonts_v1/lib/google/apis/webfonts_v1/gem_version.rb b/generated/google-apis-webfonts_v1/lib/google/apis/webfonts_v1/gem_version.rb index ef416aa14..3258365ee 100644 --- a/generated/google-apis-webfonts_v1/lib/google/apis/webfonts_v1/gem_version.rb +++ b/generated/google-apis-webfonts_v1/lib/google/apis/webfonts_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200819" diff --git a/generated/google-apis-webmasters_v3/CHANGELOG.md b/generated/google-apis-webmasters_v3/CHANGELOG.md index 2f2c1f8a4..0a98fe2f7 100644 --- a/generated/google-apis-webmasters_v3/CHANGELOG.md +++ b/generated/google-apis-webmasters_v3/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-webmasters_v3 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20190428 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-webmasters_v3/OVERVIEW.md b/generated/google-apis-webmasters_v3/OVERVIEW.md index ee56e83a5..37657b374 100644 --- a/generated/google-apis-webmasters_v3/OVERVIEW.md +++ b/generated/google-apis-webmasters_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the Search Console API +# Simple REST client for version V3 of the Search Console API This is a simple client library for version V3 of the Search Console API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the Search Console API. It pro * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Webmasters service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Webmasters service in particular.) For reference information on specific calls in the Search Console API, see the {Google::Apis::WebmastersV3::WebmastersService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-webmasters_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-webmasters_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/webmaster-tools/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-webmasters_v3/google-apis-webmasters_v3.gemspec b/generated/google-apis-webmasters_v3/google-apis-webmasters_v3.gemspec index 8c07cbca9..59de46ce9 100644 --- a/generated/google-apis-webmasters_v3/google-apis-webmasters_v3.gemspec +++ b/generated/google-apis-webmasters_v3/google-apis-webmasters_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WebmastersV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Search Console API V3" + gem.summary = "Simple REST client for Search Console API V3" gem.description = - "This is the legacy REST client for Search Console API V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Search Console API V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-webmasters_v3/lib/google/apis/webmasters_v3/gem_version.rb b/generated/google-apis-webmasters_v3/lib/google/apis/webmasters_v3/gem_version.rb index 3a3e4e4c2..5ff1e1d8c 100644 --- a/generated/google-apis-webmasters_v3/lib/google/apis/webmasters_v3/gem_version.rb +++ b/generated/google-apis-webmasters_v3/lib/google/apis/webmasters_v3/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20190428" diff --git a/generated/google-apis-websecurityscanner_v1/CHANGELOG.md b/generated/google-apis-websecurityscanner_v1/CHANGELOG.md index 1d8ca90ac..3c83d505c 100644 --- a/generated/google-apis-websecurityscanner_v1/CHANGELOG.md +++ b/generated/google-apis-websecurityscanner_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-websecurityscanner_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200919 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-websecurityscanner_v1/OVERVIEW.md b/generated/google-apis-websecurityscanner_v1/OVERVIEW.md index 957c8054d..9e2c5790f 100644 --- a/generated/google-apis-websecurityscanner_v1/OVERVIEW.md +++ b/generated/google-apis-websecurityscanner_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the Web Security Scanner API +# Simple REST client for version V1 of the Web Security Scanner API This is a simple client library for version V1 of the Web Security Scanner API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the Web Security Scanner API. * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Websecurityscanner service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Websecurityscanner service in particular.) For reference information on specific calls in the Web Security Scanner API, see the {Google::Apis::WebsecurityscannerV1::WebSecurityScannerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-websecurityscanner_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-websecurityscanner_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-websecurityscanner_v1/google-apis-websecurityscanner_v1.gemspec b/generated/google-apis-websecurityscanner_v1/google-apis-websecurityscanner_v1.gemspec index 1ae0907a1..b6dca720d 100644 --- a/generated/google-apis-websecurityscanner_v1/google-apis-websecurityscanner_v1.gemspec +++ b/generated/google-apis-websecurityscanner_v1/google-apis-websecurityscanner_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WebsecurityscannerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Web Security Scanner API V1" + gem.summary = "Simple REST client for Web Security Scanner API V1" gem.description = - "This is the legacy REST client for Web Security Scanner API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Web Security Scanner API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-websecurityscanner_v1/lib/google/apis/websecurityscanner_v1/gem_version.rb b/generated/google-apis-websecurityscanner_v1/lib/google/apis/websecurityscanner_v1/gem_version.rb index 0a64dc380..120142918 100644 --- a/generated/google-apis-websecurityscanner_v1/lib/google/apis/websecurityscanner_v1/gem_version.rb +++ b/generated/google-apis-websecurityscanner_v1/lib/google/apis/websecurityscanner_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200919" diff --git a/generated/google-apis-websecurityscanner_v1alpha/CHANGELOG.md b/generated/google-apis-websecurityscanner_v1alpha/CHANGELOG.md index bb4fb4278..fadc0afe0 100644 --- a/generated/google-apis-websecurityscanner_v1alpha/CHANGELOG.md +++ b/generated/google-apis-websecurityscanner_v1alpha/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-websecurityscanner_v1alpha -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200826 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-websecurityscanner_v1alpha/OVERVIEW.md b/generated/google-apis-websecurityscanner_v1alpha/OVERVIEW.md index 7d92d18ca..2878bc91f 100644 --- a/generated/google-apis-websecurityscanner_v1alpha/OVERVIEW.md +++ b/generated/google-apis-websecurityscanner_v1alpha/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1alpha of the Web Security Scanner API +# Simple REST client for version V1alpha of the Web Security Scanner API This is a simple client library for version V1alpha of the Web Security Scanner API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1alpha of the Web Security Scanner * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Websecurityscanner service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Websecurityscanner service in particular.) For reference information on specific calls in the Web Security Scanner API, see the {Google::Apis::WebsecurityscannerV1alpha::WebSecurityScannerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-websecurityscanner_v1alpha`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-websecurityscanner_v1alpha`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-websecurityscanner_v1alpha/google-apis-websecurityscanner_v1alpha.gemspec b/generated/google-apis-websecurityscanner_v1alpha/google-apis-websecurityscanner_v1alpha.gemspec index 809ded91f..704f7f073 100644 --- a/generated/google-apis-websecurityscanner_v1alpha/google-apis-websecurityscanner_v1alpha.gemspec +++ b/generated/google-apis-websecurityscanner_v1alpha/google-apis-websecurityscanner_v1alpha.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WebsecurityscannerV1alpha::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Web Security Scanner API V1alpha" + gem.summary = "Simple REST client for Web Security Scanner API V1alpha" gem.description = - "This is the legacy REST client for Web Security Scanner API V1alpha." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Web Security Scanner API V1alpha." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-websecurityscanner_v1alpha/lib/google/apis/websecurityscanner_v1alpha/gem_version.rb b/generated/google-apis-websecurityscanner_v1alpha/lib/google/apis/websecurityscanner_v1alpha/gem_version.rb index 99f154e24..aff1e5b18 100644 --- a/generated/google-apis-websecurityscanner_v1alpha/lib/google/apis/websecurityscanner_v1alpha/gem_version.rb +++ b/generated/google-apis-websecurityscanner_v1alpha/lib/google/apis/websecurityscanner_v1alpha/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200826" diff --git a/generated/google-apis-websecurityscanner_v1beta/CHANGELOG.md b/generated/google-apis-websecurityscanner_v1beta/CHANGELOG.md index 5bfdcd4d3..e80caed9c 100644 --- a/generated/google-apis-websecurityscanner_v1beta/CHANGELOG.md +++ b/generated/google-apis-websecurityscanner_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-websecurityscanner_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200919 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-websecurityscanner_v1beta/OVERVIEW.md b/generated/google-apis-websecurityscanner_v1beta/OVERVIEW.md index 8dd7bc487..6dfedee92 100644 --- a/generated/google-apis-websecurityscanner_v1beta/OVERVIEW.md +++ b/generated/google-apis-websecurityscanner_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Web Security Scanner API +# Simple REST client for version V1beta of the Web Security Scanner API This is a simple client library for version V1beta of the Web Security Scanner API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Web Security Scanner A * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Websecurityscanner service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Websecurityscanner service in particular.) For reference information on specific calls in the Web Security Scanner API, see the {Google::Apis::WebsecurityscannerV1beta::WebSecurityScannerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-websecurityscanner_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-websecurityscanner_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-websecurityscanner_v1beta/google-apis-websecurityscanner_v1beta.gemspec b/generated/google-apis-websecurityscanner_v1beta/google-apis-websecurityscanner_v1beta.gemspec index 96a889ff6..d0628e27b 100644 --- a/generated/google-apis-websecurityscanner_v1beta/google-apis-websecurityscanner_v1beta.gemspec +++ b/generated/google-apis-websecurityscanner_v1beta/google-apis-websecurityscanner_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WebsecurityscannerV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Web Security Scanner API V1beta" + gem.summary = "Simple REST client for Web Security Scanner API V1beta" gem.description = - "This is the legacy REST client for Web Security Scanner API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Web Security Scanner API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-websecurityscanner_v1beta/lib/google/apis/websecurityscanner_v1beta/gem_version.rb b/generated/google-apis-websecurityscanner_v1beta/lib/google/apis/websecurityscanner_v1beta/gem_version.rb index 5c841fcff..9b91ccf0f 100644 --- a/generated/google-apis-websecurityscanner_v1beta/lib/google/apis/websecurityscanner_v1beta/gem_version.rb +++ b/generated/google-apis-websecurityscanner_v1beta/lib/google/apis/websecurityscanner_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200919" diff --git a/generated/google-apis-workflowexecutions_v1beta/OVERVIEW.md b/generated/google-apis-workflowexecutions_v1beta/OVERVIEW.md index 88eb33648..9bea445c8 100644 --- a/generated/google-apis-workflowexecutions_v1beta/OVERVIEW.md +++ b/generated/google-apis-workflowexecutions_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Workflow Executions API +# Simple REST client for version V1beta of the Workflow Executions API This is a simple client library for version V1beta of the Workflow Executions API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Workflow Executions AP * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Workflowexecutions service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Workflowexecutions service in particular.) For reference information on specific calls in the Workflow Executions API, see the {Google::Apis::WorkflowexecutionsV1beta::WorkflowExecutionsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-workflowexecutions_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-workflowexecutions_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/workflows) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-workflowexecutions_v1beta/google-apis-workflowexecutions_v1beta.gemspec b/generated/google-apis-workflowexecutions_v1beta/google-apis-workflowexecutions_v1beta.gemspec index afd57a081..7d3dc89ae 100644 --- a/generated/google-apis-workflowexecutions_v1beta/google-apis-workflowexecutions_v1beta.gemspec +++ b/generated/google-apis-workflowexecutions_v1beta/google-apis-workflowexecutions_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WorkflowexecutionsV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Workflow Executions API V1beta" + gem.summary = "Simple REST client for Workflow Executions API V1beta" gem.description = - "This is the legacy REST client for Workflow Executions API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Workflow Executions API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-workflows_v1beta/CHANGELOG.md b/generated/google-apis-workflows_v1beta/CHANGELOG.md index 8665f8973..a537d8845 100644 --- a/generated/google-apis-workflows_v1beta/CHANGELOG.md +++ b/generated/google-apis-workflows_v1beta/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-workflows_v1beta -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201207 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-workflows_v1beta/OVERVIEW.md b/generated/google-apis-workflows_v1beta/OVERVIEW.md index 16db845d6..0d671dbab 100644 --- a/generated/google-apis-workflows_v1beta/OVERVIEW.md +++ b/generated/google-apis-workflows_v1beta/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1beta of the Workflows API +# Simple REST client for version V1beta of the Workflows API This is a simple client library for version V1beta of the Workflows API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1beta of the Workflows API. It prov * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Workflows service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Workflows service in particular.) For reference information on specific calls in the Workflows API, see the {Google::Apis::WorkflowsV1beta::WorkflowsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-workflows_v1beta`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-workflows_v1beta`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://cloud.google.com/workflows) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-workflows_v1beta/google-apis-workflows_v1beta.gemspec b/generated/google-apis-workflows_v1beta/google-apis-workflows_v1beta.gemspec index 48418ead9..04dc8e2fe 100644 --- a/generated/google-apis-workflows_v1beta/google-apis-workflows_v1beta.gemspec +++ b/generated/google-apis-workflows_v1beta/google-apis-workflows_v1beta.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::WorkflowsV1beta::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for Workflows API V1beta" + gem.summary = "Simple REST client for Workflows API V1beta" gem.description = - "This is the legacy REST client for Workflows API V1beta." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for Workflows API V1beta." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-workflows_v1beta/lib/google/apis/workflows_v1beta/gem_version.rb b/generated/google-apis-workflows_v1beta/lib/google/apis/workflows_v1beta/gem_version.rb index 25867c28c..aad9a22b6 100644 --- a/generated/google-apis-workflows_v1beta/lib/google/apis/workflows_v1beta/gem_version.rb +++ b/generated/google-apis-workflows_v1beta/lib/google/apis/workflows_v1beta/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201207" diff --git a/generated/google-apis-youtube_analytics_v1/CHANGELOG.md b/generated/google-apis-youtube_analytics_v1/CHANGELOG.md index bff0891b1..9ada643b9 100644 --- a/generated/google-apis-youtube_analytics_v1/CHANGELOG.md +++ b/generated/google-apis-youtube_analytics_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-youtube_analytics_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) -* Regenerated from discovery document revision 20201215 -* Regenerated using generator version 0.1.0 +* Regenerated from discovery document revision 20210105 +* Regenerated using generator version 0.1.1 diff --git a/generated/google-apis-youtube_analytics_v1/OVERVIEW.md b/generated/google-apis-youtube_analytics_v1/OVERVIEW.md index 25d0deac9..bee6abfec 100644 --- a/generated/google-apis-youtube_analytics_v1/OVERVIEW.md +++ b/generated/google-apis-youtube_analytics_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the YouTube Analytics API +# Simple REST client for version V1 of the YouTube Analytics API This is a simple client library for version V1 of the YouTube Analytics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the YouTube Analytics API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the YoutubeAnalytics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the YoutubeAnalytics service in particular.) For reference information on specific calls in the YouTube Analytics API, see the {Google::Apis::YoutubeAnalyticsV1::YouTubeAnalyticsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-youtube_analytics_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-youtube_analytics_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/youtube/analytics) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-youtube_analytics_v1/google-apis-youtube_analytics_v1.gemspec b/generated/google-apis-youtube_analytics_v1/google-apis-youtube_analytics_v1.gemspec index 3a56c81bc..db5138413 100644 --- a/generated/google-apis-youtube_analytics_v1/google-apis-youtube_analytics_v1.gemspec +++ b/generated/google-apis-youtube_analytics_v1/google-apis-youtube_analytics_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::YoutubeAnalyticsV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for YouTube Analytics API V1" + gem.summary = "Simple REST client for YouTube Analytics API V1" gem.description = - "This is the legacy REST client for YouTube Analytics API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for YouTube Analytics API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-youtube_analytics_v1/lib/google/apis/youtube_analytics_v1/gem_version.rb b/generated/google-apis-youtube_analytics_v1/lib/google/apis/youtube_analytics_v1/gem_version.rb index c8db1ffe4..fa5272b06 100644 --- a/generated/google-apis-youtube_analytics_v1/lib/google/apis/youtube_analytics_v1/gem_version.rb +++ b/generated/google-apis-youtube_analytics_v1/lib/google/apis/youtube_analytics_v1/gem_version.rb @@ -19,10 +19,10 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from - REVISION = "20201215" + REVISION = "20210105" end end end diff --git a/generated/google-apis-youtube_analytics_v2/CHANGELOG.md b/generated/google-apis-youtube_analytics_v2/CHANGELOG.md index 059136f69..01a7a7fa9 100644 --- a/generated/google-apis-youtube_analytics_v2/CHANGELOG.md +++ b/generated/google-apis-youtube_analytics_v2/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-youtube_analytics_v2 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-youtube_analytics_v2/OVERVIEW.md b/generated/google-apis-youtube_analytics_v2/OVERVIEW.md index bd81f741e..5940bbdb1 100644 --- a/generated/google-apis-youtube_analytics_v2/OVERVIEW.md +++ b/generated/google-apis-youtube_analytics_v2/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V2 of the YouTube Analytics API +# Simple REST client for version V2 of the YouTube Analytics API This is a simple client library for version V2 of the YouTube Analytics API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V2 of the YouTube Analytics API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the YoutubeAnalytics service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the YoutubeAnalytics service in particular.) For reference information on specific calls in the YouTube Analytics API, see the {Google::Apis::YoutubeAnalyticsV2::YouTubeAnalyticsService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-youtube_analytics_v2`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-youtube_analytics_v2`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/youtube/analytics) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-youtube_analytics_v2/google-apis-youtube_analytics_v2.gemspec b/generated/google-apis-youtube_analytics_v2/google-apis-youtube_analytics_v2.gemspec index cc12a3255..d88aff140 100644 --- a/generated/google-apis-youtube_analytics_v2/google-apis-youtube_analytics_v2.gemspec +++ b/generated/google-apis-youtube_analytics_v2/google-apis-youtube_analytics_v2.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::YoutubeAnalyticsV2::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for YouTube Analytics API V2" + gem.summary = "Simple REST client for YouTube Analytics API V2" gem.description = - "This is the legacy REST client for YouTube Analytics API V2." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for YouTube Analytics API V2." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-youtube_analytics_v2/lib/google/apis/youtube_analytics_v2/gem_version.rb b/generated/google-apis-youtube_analytics_v2/lib/google/apis/youtube_analytics_v2/gem_version.rb index 39292c134..945264861 100644 --- a/generated/google-apis-youtube_analytics_v2/lib/google/apis/youtube_analytics_v2/gem_version.rb +++ b/generated/google-apis-youtube_analytics_v2/lib/google/apis/youtube_analytics_v2/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/generated/google-apis-youtube_partner_v1/CHANGELOG.md b/generated/google-apis-youtube_partner_v1/CHANGELOG.md index 92a2cfd77..57b1454e4 100644 --- a/generated/google-apis-youtube_partner_v1/CHANGELOG.md +++ b/generated/google-apis-youtube_partner_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-youtube_partner_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20201217 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-youtube_partner_v1/OVERVIEW.md b/generated/google-apis-youtube_partner_v1/OVERVIEW.md index 711ed4eb0..12a6e1120 100644 --- a/generated/google-apis-youtube_partner_v1/OVERVIEW.md +++ b/generated/google-apis-youtube_partner_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the YouTube Content ID API +# Simple REST client for version V1 of the YouTube Content ID API This is a simple client library for version V1 of the YouTube Content ID API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the YouTube Content ID API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the YoutubePartner service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the YoutubePartner service in particular.) For reference information on specific calls in the YouTube Content ID API, see the {Google::Apis::YoutubePartnerV1::YouTubePartnerService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-youtube_partner_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-youtube_partner_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://devsite.googleplex.com/youtube/partner/docs/v1/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-youtube_partner_v1/google-apis-youtube_partner_v1.gemspec b/generated/google-apis-youtube_partner_v1/google-apis-youtube_partner_v1.gemspec index dd98662b4..014a9479b 100644 --- a/generated/google-apis-youtube_partner_v1/google-apis-youtube_partner_v1.gemspec +++ b/generated/google-apis-youtube_partner_v1/google-apis-youtube_partner_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::YoutubePartnerV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for YouTube Content ID API V1" + gem.summary = "Simple REST client for YouTube Content ID API V1" gem.description = - "This is the legacy REST client for YouTube Content ID API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for YouTube Content ID API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-youtube_partner_v1/lib/google/apis/youtube_partner_v1/gem_version.rb b/generated/google-apis-youtube_partner_v1/lib/google/apis/youtube_partner_v1/gem_version.rb index ffa1e1ae1..d62d3101f 100644 --- a/generated/google-apis-youtube_partner_v1/lib/google/apis/youtube_partner_v1/gem_version.rb +++ b/generated/google-apis-youtube_partner_v1/lib/google/apis/youtube_partner_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20201217" diff --git a/generated/google-apis-youtube_v3/OVERVIEW.md b/generated/google-apis-youtube_v3/OVERVIEW.md index 58b11b76d..7ce24e639 100644 --- a/generated/google-apis-youtube_v3/OVERVIEW.md +++ b/generated/google-apis-youtube_v3/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V3 of the YouTube Data API v3 +# Simple REST client for version V3 of the YouTube Data API v3 This is a simple client library for version V3 of the YouTube Data API v3. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V3 of the YouTube Data API v3. It pr * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Youtube service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Youtube service in particular.) For reference information on specific calls in the YouTube Data API v3, see the {Google::Apis::YoutubeV3::YouTubeService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-youtube_v3`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-youtube_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/youtube/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-youtube_v3/google-apis-youtube_v3.gemspec b/generated/google-apis-youtube_v3/google-apis-youtube_v3.gemspec index f852a9081..102523524 100644 --- a/generated/google-apis-youtube_v3/google-apis-youtube_v3.gemspec +++ b/generated/google-apis-youtube_v3/google-apis-youtube_v3.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::YoutubeV3::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for YouTube Data API v3 V3" + gem.summary = "Simple REST client for YouTube Data API v3 V3" gem.description = - "This is the legacy REST client for YouTube Data API v3 V3." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for YouTube Data API v3 V3." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-youtubereporting_v1/CHANGELOG.md b/generated/google-apis-youtubereporting_v1/CHANGELOG.md index ebdc811a7..08e84e6d9 100644 --- a/generated/google-apis-youtubereporting_v1/CHANGELOG.md +++ b/generated/google-apis-youtubereporting_v1/CHANGELOG.md @@ -1,7 +1,7 @@ # Release history for google-apis-youtubereporting_v1 -### v0.1.0 (2021-01-01) +### v0.1.0 (2021-01-07) +* Regenerated using generator version 0.1.1 * Regenerated from discovery document revision 20200801 -* Regenerated using generator version 0.1.0 diff --git a/generated/google-apis-youtubereporting_v1/OVERVIEW.md b/generated/google-apis-youtubereporting_v1/OVERVIEW.md index 238da4d01..fcf341cc1 100644 --- a/generated/google-apis-youtubereporting_v1/OVERVIEW.md +++ b/generated/google-apis-youtubereporting_v1/OVERVIEW.md @@ -1,4 +1,4 @@ -# Legacy REST client for version V1 of the YouTube Reporting API +# Simple REST client for version V1 of the YouTube Reporting API This is a simple client library for version V1 of the YouTube Reporting API. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version V1 of the YouTube Reporting API. It * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the Youtubereporting service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Youtubereporting service in particular.) For reference information on specific calls in the YouTube Reporting API, see the {Google::Apis::YoutubereportingV1::YouTubeReportingService class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `google-apis-youtubereporting_v1`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `google-apis-youtubereporting_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](https://developers.google.com/youtube/reporting/v1/reports/) may provide guidance regarding the preferred client library to use. diff --git a/generated/google-apis-youtubereporting_v1/google-apis-youtubereporting_v1.gemspec b/generated/google-apis-youtubereporting_v1/google-apis-youtubereporting_v1.gemspec index c5dd1d3fd..b8250d652 100644 --- a/generated/google-apis-youtubereporting_v1/google-apis-youtubereporting_v1.gemspec +++ b/generated/google-apis-youtubereporting_v1/google-apis-youtubereporting_v1.gemspec @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = Google::Apis::YoutubereportingV1::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for YouTube Reporting API V1" + gem.summary = "Simple REST client for YouTube Reporting API V1" gem.description = - "This is the legacy REST client for YouTube Reporting API V1." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for YouTube Reporting API V1." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/generated/google-apis-youtubereporting_v1/lib/google/apis/youtubereporting_v1/gem_version.rb b/generated/google-apis-youtubereporting_v1/lib/google/apis/youtubereporting_v1/gem_version.rb index b5368015e..f1162b9a1 100644 --- a/generated/google-apis-youtubereporting_v1/lib/google/apis/youtubereporting_v1/gem_version.rb +++ b/generated/google-apis-youtubereporting_v1/lib/google/apis/youtubereporting_v1/gem_version.rb @@ -19,7 +19,7 @@ module Google GEM_VERSION = "0.1.0" # Version of the code generator used to generate this client - GENERATOR_VERSION = "0.1.0" + GENERATOR_VERSION = "0.1.1" # Revision of the discovery document this client was generated from REVISION = "20200801" diff --git a/google-apis-generator/lib/google/apis/generator/templates/gemspec.tmpl b/google-apis-generator/lib/google/apis/generator/templates/gemspec.tmpl index 1a64749ba..efdc74879 100644 --- a/google-apis-generator/lib/google/apis/generator/templates/gemspec.tmpl +++ b/google-apis-generator/lib/google/apis/generator/templates/gemspec.tmpl @@ -5,10 +5,10 @@ Gem::Specification.new do |gem| gem.version = <%= api.qualified_name %>::GEM_VERSION gem.authors = ["Google LLC"] gem.email = "googleapis-packages@google.com" - gem.summary = "Legacy REST client for <%= api.title %> <%= api.version %>" + gem.summary = "Simple REST client for <%= api.title %> <%= api.version %>" gem.description = - "This is the legacy REST client for <%= api.title %> <%= api.version %>." \ - " Legacy REST clients are simple Ruby libraries that provide access to" \ + "This is the simple REST client for <%= api.title %> <%= api.version %>." \ + " Simple REST clients are Ruby client libraries that provide access to" \ " Google services via their HTTP REST API endpoints. These libraries are" \ " generated and updated automatically based on the discovery documents" \ " published by the service, and they handle most concerns such as" \ diff --git a/google-apis-generator/lib/google/apis/generator/templates/overview.md.tmpl b/google-apis-generator/lib/google/apis/generator/templates/overview.md.tmpl index a59551ea7..fe4974b90 100644 --- a/google-apis-generator/lib/google/apis/generator/templates/overview.md.tmpl +++ b/google-apis-generator/lib/google/apis/generator/templates/overview.md.tmpl @@ -1,4 +1,4 @@ -# Legacy REST client for version <%= api.version %> of the <%= api.title %> +# Simple REST client for version <%= api.version %> of the <%= api.title %> This is a simple client library for version <%= api.version %> of the <%= api.title %>. It provides: @@ -7,7 +7,7 @@ This is a simple client library for version <%= api.version %> of the <%= api.ti * Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts. * Control of retry, pagination, and timeouts. -Note that although this client library is supported and will continue to be updated to track changes to the service, it is considered legacy. A more modern client may be available for many Google services, especially Cloud Platform services. See the section below titled *Which client should I use?* for more information. +Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information. ## Getting started @@ -58,26 +58,26 @@ See the class reference docs for information on the methods you can call from a ## Documentation -More detailed descriptions of the Google legacy REST clients are available in two documents. +More detailed descriptions of the Google simple REST clients are available in two documents. * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging. * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables. -(Note: the above documents are written for the legacy clients in general, and their examples may not reflect the <%= api.name %> service in particular.) +(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the <%= api.name %> service in particular.) For reference information on specific calls in the <%= api.title %>, see the {<%= api.qualified_name %>::<%= api.service_name %> class reference docs}. ## Which client should I use? -Google provides two types of Ruby API client libraries: **legacy REST clients** and **modern clients**. +Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**. -This library, `<%= api.gem_name %>`, is a legacy REST client. You can identify legacy clients by their gem names, which are always in the form `google-apis-_`. The legacy REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. +This library, `<%= api.gem_name %>`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-_`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward. -Modern clients are produced by a modern code generator, combined with hand-crafted functionality for some services. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Cloud Platform services, but do not yet support all the services covered by the legacy clients. +Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients. Gem names for modern clients are often of the form `google-cloud-`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud--`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended. -**For most users, we recommend the modern client, if one is available.** Compared with legacy clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a legacy client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. +**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure. The [product documentation](<%= api.documentation_link %>) may provide guidance regarding the preferred client library to use.