diff --git a/generated/google/apis/adexchangebuyer2_v2beta1.rb b/generated/google/apis/adexchangebuyer2_v2beta1.rb
index c7b1af4d5..41418f71d 100644
--- a/generated/google/apis/adexchangebuyer2_v2beta1.rb
+++ b/generated/google/apis/adexchangebuyer2_v2beta1.rb
@@ -27,7 +27,7 @@ module Google
     # @see https://developers.google.com/authorized-buyers/apis/reference/rest/
     module Adexchangebuyer2V2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200506'
+      REVISION = '20200520'
 
       # Manage your Ad Exchange buyer account configuration
       AUTH_ADEXCHANGE_BUYER = 'https://www.googleapis.com/auth/adexchange.buyer'
diff --git a/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb b/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb
index 995761b35..b43b0a231 100644
--- a/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb
+++ b/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb
@@ -440,6 +440,7 @@ module Google
         # Numerical identifier of the client entity.
         # The entity can be an advertiser, a brand, or an agency.
         # This identifier is unique among all the entities with the same type.
+        # The value of this field is ignored if the entity type is not provided.
         # A list of all known advertisers with their identifiers is available in the
         # [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/
         # advertisers.txt)
@@ -462,7 +463,8 @@ module Google
         # @return [String]
         attr_accessor :entity_name
       
-        # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
+        # An optional field for specifying the type of the client entity:
+        # `ADVERTISER`, `BRAND`, or `AGENCY`.
         # Corresponds to the JSON property `entityType`
         # @return [String]
         attr_accessor :entity_type
diff --git a/generated/google/apis/bigqueryreservation_v1.rb b/generated/google/apis/bigqueryreservation_v1.rb
index 48f89eafd..3d7126b70 100644
--- a/generated/google/apis/bigqueryreservation_v1.rb
+++ b/generated/google/apis/bigqueryreservation_v1.rb
@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryreservationV1
       VERSION = 'V1'
-      REVISION = '20200509'
+      REVISION = '20200516'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
diff --git a/generated/google/apis/bigqueryreservation_v1/service.rb b/generated/google/apis/bigqueryreservation_v1/service.rb
index 39f18e5e5..6d60525e0 100644
--- a/generated/google/apis/bigqueryreservation_v1/service.rb
+++ b/generated/google/apis/bigqueryreservation_v1/service.rb
@@ -179,7 +179,7 @@ module Google
         #   Required. The resource name of the admin project(containing project and
         #   location),
         #   e.g.:
-        #   "projects/myproject/locations/US".
+        #   `projects/myproject/locations/US`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return per page.
         # @param [String] page_token
@@ -266,7 +266,7 @@ module Google
         # Creates a new capacity commitment resource.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1::CapacityCommitment] capacity_commitment_object
         # @param [Boolean] enforce_single_admin_project_per_org
         #   If true, fail the request if another project in the organization has a
@@ -306,7 +306,7 @@ module Google
         # `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to delete. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -337,7 +337,7 @@ module Google
         # Returns information about the capacity commitment.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to retrieve. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -368,7 +368,7 @@ module Google
         # Lists all the capacity commitments for the admin project.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -409,7 +409,7 @@ module Google
         # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] parent
         #   Parent resource that identifies admin project and location e.g.,
-        #   projects/myproject/locations/us
+        #   `projects/myproject/locations/us`
         # @param [Google::Apis::BigqueryreservationV1::MergeCapacityCommitmentsRequest] merge_capacity_commitments_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -489,7 +489,7 @@ module Google
         # you would change the plan of the first one to `FLEX` and then delete it.
         # @param [String] name
         #   Required. The resource name e.g.,:
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1::SplitCapacityCommitmentRequest] split_capacity_commitment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -625,7 +625,7 @@ module Google
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
         #   Required. The parent resource name containing project and location, e.g.:
-        #   "projects/myproject/locations/US"
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return per page.
         # @param [String] page_token
diff --git a/generated/google/apis/bigqueryreservation_v1beta1.rb b/generated/google/apis/bigqueryreservation_v1beta1.rb
index 988cce6ad..7bb98fbef 100644
--- a/generated/google/apis/bigqueryreservation_v1beta1.rb
+++ b/generated/google/apis/bigqueryreservation_v1beta1.rb
@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryreservationV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200509'
+      REVISION = '20200516'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
diff --git a/generated/google/apis/bigqueryreservation_v1beta1/classes.rb b/generated/google/apis/bigqueryreservation_v1beta1/classes.rb
index fad2551f8..7c8bed2e0 100644
--- a/generated/google/apis/bigqueryreservation_v1beta1/classes.rb
+++ b/generated/google/apis/bigqueryreservation_v1beta1/classes.rb
@@ -28,7 +28,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The resource which will use the reservation. E.g.
-        # projects/myproject, folders/123, organizations/456.
+        # `projects/myproject`, `folders/123`, or `organizations/456`.
         # Corresponds to the JSON property `assignee`
         # @return [String]
         attr_accessor :assignee
@@ -39,7 +39,7 @@ module Google
         attr_accessor :job_type
       
         # Output only. Name of the resource. E.g.:
-        # projects/myproject/locations/US/reservations/team1-prod/assignments/123.
+        # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -98,8 +98,9 @@ module Google
       # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
       # (in the form of slots) with some committed period of usage. Annual
       # commitments renew by default. Commitments can be removed after their
-      # commitment end time passes. In order to remove annual commitment, its plan
-      # needs to be changed to monthly or flex first.
+      # commitment end time passes.
+      # In order to remove annual commitment, its plan needs to be changed
+      # to monthly or flex first.
       # A capacity commitment resource exists as a child resource of the admin
       # project.
       class CapacityCommitment
@@ -123,7 +124,7 @@ module Google
         attr_accessor :failure_status
       
         # Output only. The resource name of the capacity commitment, e.g.,
-        # projects/myproject/locations/US/capacityCommitments/123
+        # `projects/myproject/locations/US/capacityCommitments/123`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -307,15 +308,16 @@ module Google
       
       # The request for
       # ReservationService.MoveAssignment.
-      # Note: "bigquery.reservationAssignments.create" permission is required on the
-      # destination_id. Note: "bigquery.reservationAssignments.create" and
-      # "bigquery.reservationAssignments.delete" permission is required on the
+      # **Note**: "bigquery.reservationAssignments.create" permission is required on
+      # the destination_id.
+      # **Note**: "bigquery.reservationAssignments.create" and
+      # "bigquery.reservationAssignments.delete" permission are required on the
       # related assignee.
       class MoveAssignmentRequest
         include Google::Apis::Core::Hashable
       
         # The new reservation ID, e.g.:
-        # projects/myotherproject/locations/US/reservations/team2-prod
+        # `projects/myotherproject/locations/US/reservations/team2-prod`
         # Corresponds to the JSON property `destinationId`
         # @return [String]
         attr_accessor :destination_id
@@ -343,7 +345,7 @@ module Google
         alias_method :ignore_idle_slots?, :ignore_idle_slots
       
         # The resource name of the reservation, e.g.,
-        # "projects/*/locations/*/reservations/team1-prod".
+        # `projects/*/locations/*/reservations/team1-prod`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -424,8 +426,9 @@ module Google
         # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
         # (in the form of slots) with some committed period of usage. Annual
         # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes. In order to remove annual commitment, its plan
-        # needs to be changed to monthly or flex first.
+        # commitment end time passes.
+        # In order to remove annual commitment, its plan needs to be changed
+        # to monthly or flex first.
         # A capacity commitment resource exists as a child resource of the admin
         # project.
         # Corresponds to the JSON property `first`
@@ -435,8 +438,9 @@ module Google
         # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
         # (in the form of slots) with some committed period of usage. Annual
         # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes. In order to remove annual commitment, its plan
-        # needs to be changed to monthly or flex first.
+        # commitment end time passes.
+        # In order to remove annual commitment, its plan needs to be changed
+        # to monthly or flex first.
         # A capacity commitment resource exists as a child resource of the admin
         # project.
         # Corresponds to the JSON property `second`
diff --git a/generated/google/apis/bigqueryreservation_v1beta1/service.rb b/generated/google/apis/bigqueryreservation_v1beta1/service.rb
index 1ca466c43..c218e45ef 100644
--- a/generated/google/apis/bigqueryreservation_v1beta1/service.rb
+++ b/generated/google/apis/bigqueryreservation_v1beta1/service.rb
@@ -80,34 +80,36 @@ module Google
         
         # Looks up assignments for a specified resource for a particular region.
         # If the request is about a project:
-        # 1) Assignments created on the project will be returned if they exist.
-        # 2) Otherwise assignments created on the closest ancestor will be
-        # returned. 3) Assignments for different JobTypes will all be returned.
-        # Same logic applies if the request is about a folder.
+        # 1. Assignments created on the project will be returned if they exist.
+        # 2. Otherwise assignments created on the closest ancestor will be
+        # returned.
+        # 3. Assignments for different JobTypes will all be returned.
+        # The same logic applies if the request is about a folder.
         # If the request is about an organization, then assignments created on the
         # organization will be returned (organization doesn't have ancestors).
         # Comparing to ListAssignments, there are some behavior
         # differences:
-        # 1) permission on the assignee will be verified in this API.
-        # 2) Hierarchy lookup (project->folder->organization) happens in this API.
-        # 3) Parent here is projects/*/locations/*, instead of
-        # projects/*/locations/*reservations/*.
-        # Note "-" cannot be used for projects
+        # 1. permission on the assignee will be verified in this API.
+        # 2. Hierarchy lookup (project->folder->organization) happens in this API.
+        # 3. Parent here is `projects/*/locations/*`, instead of
+        # `projects/*/locations/*reservations/*`.
+        # **Note** "-" cannot be used for projects
         # nor locations.
         # @param [String] parent
         #   Required. The resource name of the admin project(containing project and
         #   location),
         #   e.g.:
-        #   "projects/myproject/locations/US".
+        #   `projects/myproject/locations/US`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] query
         #   Please specify resource name as assignee in the query.
-        #   e.g., "assignee=projects/myproject"
-        #   "assignee=folders/123"
-        #   "assignee=organizations/456"
+        #   Examples:
+        #   * `assignee=projects/myproject`
+        #   * `assignee=folders/123`
+        #   * `assignee=organizations/456`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -139,8 +141,8 @@ module Google
         end
         
         # Updates a BI reservation.
-        # Only fields specified in the field_mask are updated.
-        # Singleton BI reservation always exists with default size 0.
+        # Only fields specified in the `field_mask` are updated.
+        # A singleton BI reservation always exists with default size 0.
         # In order to reserve BI capacity it needs to be updated to an amount
         # greater than 0. In order to release BI capacity reservation size
         # must be set to 0.
@@ -184,7 +186,7 @@ module Google
         # Creates a new capacity commitment resource.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [Boolean] enforce_single_admin_project_per_org
         #   If true, fail the request if another project in the organization has a
@@ -224,7 +226,7 @@ module Google
         # `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to delete. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -255,7 +257,7 @@ module Google
         # Returns information about the capacity commitment.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to retrieve. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -286,7 +288,7 @@ module Google
         # Lists all the capacity commitments for the admin project.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -320,13 +322,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Merges capacity commitments of the same plan into one. Resulting capacity
-        # commitment has the longer commitment_end_time out of the two. Attempting to
-        # merge capacity commitments of different plan will fail with the error code
-        # `google.rpc.Code.FAILED_PRECONDITION`.
+        # Merges capacity commitments of the same plan into a single commitment.
+        # The resulting capacity commitment has the greater commitment_end_time
+        # out of the to-be-merged capacity commitments.
+        # Attempting to merge capacity commitments of different plan will fail
+        # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] parent
         #   Parent resource that identifies admin project and location e.g.,
-        #   projects/myproject/locations/us
+        #   `projects/myproject/locations/us`
         # @param [Google::Apis::BigqueryreservationV1beta1::MergeCapacityCommitmentsRequest] merge_capacity_commitments_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -358,13 +361,13 @@ module Google
         end
         
         # Updates an existing capacity commitment.
-        # Only plan and renewal_plan fields can be updated.
+        # Only `plan` and `renewal_plan` fields can be updated.
         # Plan can only be changed to a plan of a longer commitment period.
         # Attempting to change to a plan with shorter commitment period will fail
         # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Output only. The resource name of the capacity commitment, e.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -399,13 +402,14 @@ module Google
         end
         
         # Splits capacity commitment to two commitments of the same plan and
-        # commitment_end_time. A common use case to do that is to perform a downgrade
-        # e.g., in order to downgrade from 10000 slots to 8000, one might split 10000
-        # capacity commitment to 2000 and 8000, change the plan of the first one to
-        # flex and then delete it.
+        # `commitment_end_time`.
+        # A common use case is to enable downgrading commitments.
+        # For example, in order to downgrade from 10000 slots to 8000, you might
+        # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
+        # you would change the plan of the first one to `FLEX` and then delete it.
         # @param [String] name
         #   Required. The resource name e.g.,:
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::SplitCapacityCommitmentRequest] split_capacity_commitment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -439,7 +443,7 @@ module Google
         # Creates a new reservation resource.
         # @param [String] parent
         #   Required. Project, location. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] reservation_id
         #   The reservation ID. This field must only contain lower case alphanumeric
@@ -479,7 +483,7 @@ module Google
         # assignments.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -510,7 +514,7 @@ module Google
         # Returns information about the reservation.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -541,7 +545,7 @@ module Google
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
         #   Required. The parent resource name containing project and location, e.g.:
-        #   "projects/myproject/locations/US"
+        #   `projects/myproject/locations/US`
         # @param [String] filter
         #   Can be used to filter out reservations based on names, capacity, etc, e.g.:
         #   filter="reservation.slot_capacity > 200"
@@ -585,7 +589,7 @@ module Google
         # Updates an existing reservation resource.
         # @param [String] name
         #   The resource name of the reservation, e.g.,
-        #   "projects/*/locations/*/reservations/team1-prod".
+        #   `projects/*/locations/*/reservations/team1-prod`.
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -619,6 +623,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates an assignment object which allows the given project to submit jobs
+        # of a certain type using slots from the specified reservation.
+        # Currently a
+        # resource (project, folder, organization) can only have one assignment per
+        # each (job_type, location) combination, and that reservation will be used
+        # for all jobs of the matching type.
+        # Different assignments can be created on different levels of the
+        # projects, folders or organization hierarchy.  During query execution,
+        # the assignment is looked up at the project, folder and organization levels
+        # in that order. The first assignment found is applied to the query.
+        # When creating assignments, it does not matter if other assignments exist at
+        # higher levels.
+        # Example:
+        # * The organization `organizationA` contains two projects, `project1`
+        # and `project2`.
+        # * Assignments for all three entities (`organizationA`, `project1`, and
+        # `project2`) could all be created and mapped to the same or different
+        # reservations.
         # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have
         # 'bigquery.admin' permissions on the project using the reservation
         # and the project that owns this reservation.
@@ -626,7 +648,7 @@ module Google
         # does not match location of the reservation.
         # @param [String] parent
         #   Required. The parent resource name of the assignment
-        #   E.g.: projects/myproject/locations/US/reservations/team1-prod
+        #   E.g. `projects/myproject/locations/US/reservations/team1-prod`
         # @param [Google::Apis::BigqueryreservationV1beta1::Assignment] assignment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -658,18 +680,20 @@ module Google
         end
         
         # Deletes a assignment. No expansion will happen.
-        # E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then deletion of <organizationA, res1> won't affect <project1, res1>. After
-        # deletion of <organizationA, res1>, queries from project1 will still use
-        # res1, while queries from project2 will use on-demand mode.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, deletion of the `<organizationA, res1>` assignment won't
+        # affect the other assignment `<project1, res1>`. After said deletion,
+        # queries from `project1` will still use `res1` while queries from
+        # `project2` will switch to use on-demand mode.
         # @param [String] name
-        #   Required. Name of the resource, e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   Required. Name of the resource, e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -698,22 +722,25 @@ module Google
         end
         
         # Lists assignments.
-        # Only explicitly created assignments will be returned. E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then this API will just return the above two assignments for reservation
-        # res1, and no expansion/merge will happen. Wildcard "-" can be used for
+        # Only explicitly created assignments will be returned.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, ListAssignments will just return the above two assignments
+        # for reservation `res1`, and no expansion/merge will happen.
+        # The wildcard "-" can be used for
         # reservations in the request. In that case all assignments belongs to the
-        # specified project and location will be listed. Note
-        # "-" cannot be used for projects nor locations.
+        # specified project and location will be listed.
+        # **Note** "-" cannot be used for projects nor locations.
         # @param [String] parent
         #   Required. The parent resource name e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         #   Or:
-        #   projects/myproject/locations/US/reservations/-
+        #   `projects/myproject/locations/US/reservations/-`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -747,16 +774,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves a assignment under a new reservation. Customers can do this by
-        # deleting the existing assignment followed by creating another assignment
-        # under the new reservation, but this method provides a transactional way to
-        # do so, to make sure the assignee always has an associated reservation.
-        # Without the method customers might see some queries run on-demand which
-        # might be unexpected.
+        # Moves an assignment under a new reservation.
+        # This differs from removing an existing assignment and recreating a new one
+        # by providing a transactional change that ensures an assignee always has an
+        # associated reservation.
         # @param [String] name
         #   Required. The resource name of the assignment,
-        #   e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::MoveAssignmentRequest] move_assignment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
diff --git a/generated/google/apis/binaryauthorization_v1.rb b/generated/google/apis/binaryauthorization_v1.rb
index 74b761ebc..f60f05d8a 100644
--- a/generated/google/apis/binaryauthorization_v1.rb
+++ b/generated/google/apis/binaryauthorization_v1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/binary-authorization/
     module BinaryauthorizationV1
       VERSION = 'V1'
-      REVISION = '20200501'
+      REVISION = '20200515'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/binaryauthorization_v1/classes.rb b/generated/google/apis/binaryauthorization_v1/classes.rb
index 96085b102..07ece1e62 100644
--- a/generated/google/apis/binaryauthorization_v1/classes.rb
+++ b/generated/google/apis/binaryauthorization_v1/classes.rb
@@ -540,7 +540,8 @@ module Google
         # @return [Array<Google::Apis::BinaryauthorizationV1::AdmissionWhitelistPattern>]
         attr_accessor :admission_whitelist_patterns
       
-        # Optional. Per-cluster admission rules. Cluster spec format:
+        # Optional. LINT.IfChange(cluster_regex)
+        # Per-cluster admission rules. Cluster spec format:
         # `location.clusterId`. There can be at most one admission rule per cluster
         # spec.
         # A `location` is either a compute zone (e.g. us-central1-a) or a region
@@ -548,6 +549,8 @@ module Google
         # For `clusterId` syntax restrictions see
         # https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.
         # clusters.
+        # LINT.ThenChange(//depot/google3/cloud/console/web/binary_authorization/api/
+        # models/admission_rule_type.ts:cluster_regex)
         # Corresponds to the JSON property `clusterAdmissionRules`
         # @return [Hash<String,Google::Apis::BinaryauthorizationV1::AdmissionRule>]
         attr_accessor :cluster_admission_rules
diff --git a/generated/google/apis/content_v2_1.rb b/generated/google/apis/content_v2_1.rb
index ad0ba2bb3..adda9ff9d 100644
--- a/generated/google/apis/content_v2_1.rb
+++ b/generated/google/apis/content_v2_1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2_1
       VERSION = 'V2_1'
-      REVISION = '20200421'
+      REVISION = '20200512'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'
diff --git a/generated/google/apis/content_v2_1/classes.rb b/generated/google/apis/content_v2_1/classes.rb
index d5ceaf9b2..6cdb8429c 100644
--- a/generated/google/apis/content_v2_1/classes.rb
+++ b/generated/google/apis/content_v2_1/classes.rb
@@ -10861,6 +10861,11 @@ module Google
         # @return [String]
         attr_accessor :merchant_order_id
       
+        # The identifier of the item.
+        # Corresponds to the JSON property `orderItemId`
+        # @return [String]
+        attr_accessor :order_item_id
+      
         # The unique ID of the settlement transaction entry.
         # Corresponds to the JSON property `settlementEntryId`
         # @return [String]
@@ -10884,6 +10889,7 @@ module Google
         def update!(**args)
           @adjustment_id = args[:adjustment_id] if args.key?(:adjustment_id)
           @merchant_order_id = args[:merchant_order_id] if args.key?(:merchant_order_id)
+          @order_item_id = args[:order_item_id] if args.key?(:order_item_id)
           @settlement_entry_id = args[:settlement_entry_id] if args.key?(:settlement_entry_id)
           @shipment_ids = args[:shipment_ids] if args.key?(:shipment_ids)
           @transaction_id = args[:transaction_id] if args.key?(:transaction_id)
diff --git a/generated/google/apis/content_v2_1/representations.rb b/generated/google/apis/content_v2_1/representations.rb
index 604191cbd..4af291469 100644
--- a/generated/google/apis/content_v2_1/representations.rb
+++ b/generated/google/apis/content_v2_1/representations.rb
@@ -4543,6 +4543,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :adjustment_id, as: 'adjustmentId'
           property :merchant_order_id, as: 'merchantOrderId'
+          property :order_item_id, as: 'orderItemId'
           property :settlement_entry_id, as: 'settlementEntryId'
           collection :shipment_ids, as: 'shipmentIds'
           property :transaction_id, as: 'transactionId'
diff --git a/generated/google/apis/dfareporting_v3_3.rb b/generated/google/apis/dfareporting_v3_3.rb
index 0f2bd4792..897436c4c 100644
--- a/generated/google/apis/dfareporting_v3_3.rb
+++ b/generated/google/apis/dfareporting_v3_3.rb
@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/doubleclick-advertisers/
     module DfareportingV3_3
       VERSION = 'V3_3'
-      REVISION = '20200326'
+      REVISION = '20200514'
 
       # Manage DoubleClick Digital Marketing conversions
       AUTH_DDMCONVERSIONS = 'https://www.googleapis.com/auth/ddmconversions'
diff --git a/generated/google/apis/dfareporting_v3_3/classes.rb b/generated/google/apis/dfareporting_v3_3/classes.rb
index 3acb93d52..91b1a3793 100644
--- a/generated/google/apis/dfareporting_v3_3/classes.rb
+++ b/generated/google/apis/dfareporting_v3_3/classes.rb
@@ -5713,7 +5713,7 @@ module Google
         end
       end
       
-      # 
+      # List of files for a report.
       class FileList
         include Google::Apis::Core::Hashable
       
@@ -5722,7 +5722,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # 
+        # The files returned in this response.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::DfareportingV3_3::File>]
         attr_accessor :items
diff --git a/generated/google/apis/dfareporting_v3_3/service.rb b/generated/google/apis/dfareporting_v3_3/service.rb
index 23b302031..bcd3ef4d9 100644
--- a/generated/google/apis/dfareporting_v3_3/service.rb
+++ b/generated/google/apis/dfareporting_v3_3/service.rb
@@ -7254,9 +7254,9 @@ module Google
         
         # Lists files for a report.
         # @param [Fixnum] profile_id
-        #   The DFA user profile ID.
+        #   The DFA profile ID.
         # @param [Fixnum] report_id
-        #   The ID of the report.
+        #   The ID of the parent report.
         # @param [Fixnum] max_results
         #   Maximum number of results to return.
         # @param [String] page_token
diff --git a/generated/google/apis/dfareporting_v3_4.rb b/generated/google/apis/dfareporting_v3_4.rb
index 3ce389f8d..1667d8d50 100644
--- a/generated/google/apis/dfareporting_v3_4.rb
+++ b/generated/google/apis/dfareporting_v3_4.rb
@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/doubleclick-advertisers/
     module DfareportingV3_4
       VERSION = 'V3_4'
-      REVISION = '20200326'
+      REVISION = '20200514'
 
       # Manage DoubleClick Digital Marketing conversions
       AUTH_DDMCONVERSIONS = 'https://www.googleapis.com/auth/ddmconversions'
diff --git a/generated/google/apis/dfareporting_v3_4/classes.rb b/generated/google/apis/dfareporting_v3_4/classes.rb
index 435760b0f..9c3ab26f3 100644
--- a/generated/google/apis/dfareporting_v3_4/classes.rb
+++ b/generated/google/apis/dfareporting_v3_4/classes.rb
@@ -6182,7 +6182,7 @@ module Google
         end
       end
       
-      # 
+      # List of files for a report.
       class FileList
         include Google::Apis::Core::Hashable
       
@@ -6191,7 +6191,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # 
+        # The files returned in this response.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::DfareportingV3_4::File>]
         attr_accessor :items
diff --git a/generated/google/apis/dfareporting_v3_4/service.rb b/generated/google/apis/dfareporting_v3_4/service.rb
index c02580283..8405ded7d 100644
--- a/generated/google/apis/dfareporting_v3_4/service.rb
+++ b/generated/google/apis/dfareporting_v3_4/service.rb
@@ -7251,9 +7251,9 @@ module Google
         
         # Lists files for a report.
         # @param [Fixnum] profile_id
-        #   The DFA user profile ID.
+        #   The DFA profile ID.
         # @param [Fixnum] report_id
-        #   The ID of the report.
+        #   The ID of the parent report.
         # @param [Fixnum] max_results
         #   Maximum number of results to return.
         # @param [String] page_token
diff --git a/generated/google/apis/dialogflow_v2.rb b/generated/google/apis/dialogflow_v2.rb
index 1829f1005..b1c806540 100644
--- a/generated/google/apis/dialogflow_v2.rb
+++ b/generated/google/apis/dialogflow_v2.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow/
     module DialogflowV2
       VERSION = 'V2'
-      REVISION = '20200512'
+      REVISION = '20200518'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/dialogflow_v2/classes.rb b/generated/google/apis/dialogflow_v2/classes.rb
index 8be6fe9be..73369c5ec 100644
--- a/generated/google/apis/dialogflow_v2/classes.rb
+++ b/generated/google/apis/dialogflow_v2/classes.rb
@@ -615,6 +615,9 @@ module Google
         # multiple default text responses exist, they will be concatenated when
         # generating audio. If no default platform text responses exist, the
         # generated audio content will be empty.
+        # In some scenarios, multiple output audio fields may be present in the
+        # response structure. In these cases, only the top-most-level audio output
+        # has content.
         # Corresponds to the JSON property `outputAudio`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
diff --git a/generated/google/apis/dialogflow_v2beta1.rb b/generated/google/apis/dialogflow_v2beta1.rb
index fc067551f..58895ca85 100644
--- a/generated/google/apis/dialogflow_v2beta1.rb
+++ b/generated/google/apis/dialogflow_v2beta1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200512'
+      REVISION = '20200518'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/dialogflow_v2beta1/classes.rb b/generated/google/apis/dialogflow_v2beta1/classes.rb
index 8e35b3e68..c8bc4fe19 100644
--- a/generated/google/apis/dialogflow_v2beta1/classes.rb
+++ b/generated/google/apis/dialogflow_v2beta1/classes.rb
@@ -2736,6 +2736,9 @@ module Google
         # multiple default text responses exist, they will be concatenated when
         # generating audio. If no default platform text responses exist, the
         # generated audio content will be empty.
+        # In some scenarios, multiple output audio fields may be present in the
+        # response structure. In these cases, only the top-most-level audio output
+        # has content.
         # Corresponds to the JSON property `outputAudio`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
diff --git a/generated/google/apis/dialogflow_v2beta1/service.rb b/generated/google/apis/dialogflow_v2beta1/service.rb
index 581bfa02f..a25ef219a 100644
--- a/generated/google/apis/dialogflow_v2beta1/service.rb
+++ b/generated/google/apis/dialogflow_v2beta1/service.rb
@@ -1833,7 +1833,7 @@ module Google
         # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
         # only use `projects.knowledgeBases.documents`.
         # @param [String] parent
-        #   The knoweldge base to create a document for.
+        #   Required. The knoweldge base to create a document for.
         #   Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
         # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
         # @param [String] fields
@@ -2736,7 +2736,7 @@ module Google
         # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
         # only use `projects.knowledgeBases.documents`.
         # @param [String] parent
-        #   The knoweldge base to create a document for.
+        #   Required. The knoweldge base to create a document for.
         #   Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
         # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
         # @param [String] fields
diff --git a/generated/google/apis/dlp_v2.rb b/generated/google/apis/dlp_v2.rb
index b155b4e8e..cfff75c29 100644
--- a/generated/google/apis/dlp_v2.rb
+++ b/generated/google/apis/dlp_v2.rb
@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/dlp/docs/
     module DlpV2
       VERSION = 'V2'
-      REVISION = '20200505'
+      REVISION = '20200516'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/dlp_v2/classes.rb b/generated/google/apis/dlp_v2/classes.rb
index 3f7a3699b..33ba3427a 100644
--- a/generated/google/apis/dlp_v2/classes.rb
+++ b/generated/google/apis/dlp_v2/classes.rb
@@ -1155,8 +1155,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate]
         attr_accessor :deidentify_template
       
-        # The geographic location to store the deidentification template. Reserved
-        # for future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -1200,8 +1199,7 @@ module Google
         # @return [String]
         attr_accessor :job_id
       
-        # The geographic location to store and process the job. Reserved for
-        # future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -1237,8 +1235,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate]
         attr_accessor :inspect_template
       
-        # The geographic location to store the inspection template. Reserved for
-        # future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -1273,8 +1270,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2JobTrigger]
         attr_accessor :job_trigger
       
-        # The geographic location to store the job trigger. Reserved for
-        # future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -1310,8 +1306,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoTypeConfig]
         attr_accessor :config
       
-        # The geographic location to store the stored infoType. Reserved for
-        # future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -1835,8 +1830,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2ContentItem]
         attr_accessor :item
       
-        # The geographic location to process de-identification. Reserved for future
-        # extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -3314,10 +3308,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2ContentItem]
         attr_accessor :item
       
-        # The geographic location to process content inspection. Reserved for future
-        # extensions.
-        # When inspecting images location is restricted to 'global', 'us', 'asia',
-        # and 'europe'.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -5262,9 +5253,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig]
         attr_accessor :inspect_config
       
-        # The geographic location to process the request. Reserved for future
-        # extensions.
-        # Location is restricted to 'global', 'us', 'asia', and 'europe'.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -5370,8 +5359,7 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2ContentItem]
         attr_accessor :item
       
-        # The geographic location to process content reidentification.  Reserved for
-        # future extensions.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
diff --git a/generated/google/apis/dlp_v2/service.rb b/generated/google/apis/dlp_v2/service.rb
index 81cb6f0e4..247ea405c 100644
--- a/generated/google/apis/dlp_v2/service.rb
+++ b/generated/google/apis/dlp_v2/service.rb
@@ -60,8 +60,9 @@ module Google
         #   names. If omitted, or if localized strings are not available,
         #   en-US strings will be returned.
         # @param [String] location_id
-        #   The geographic location to list info types. Reserved for future
-        #   extensions.
+        #   Deprecated. This field has no effect.
+        # @param [String] parent
+        #   The parent resource name, for example locations/`location_id`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -79,13 +80,14 @@ module Google
         # @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_info_types(filter: nil, language_code: nil, location_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_info_types(filter: nil, language_code: nil, location_id: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/infoTypes', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInfoTypesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInfoTypesResponse
           command.query['filter'] = filter unless filter.nil?
           command.query['languageCode'] = language_code unless language_code.nil?
           command.query['locationId'] = location_id unless location_id.nil?
+          command.query['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -94,9 +96,8 @@ module Google
         # Returns a list of the sensitive information types that the DLP API
         # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
         # learn more.
-        # @param [String] location_id
-        #   The geographic location to list info types. Reserved for future
-        #   extensions.
+        # @param [String] parent
+        #   The parent resource name, for example locations/`location_id`.
         # @param [String] filter
         #   filter to only return infoTypes supported by certain parts of the
         #   API. Defaults to supported_by=INSPECT.
@@ -104,6 +105,8 @@ module Google
         #   BCP-47 language code for localized infoType friendly
         #   names. If omitted, or if localized strings are not available,
         #   en-US strings will be returned.
+        # @param [String] location_id
+        #   Deprecated. This field has no effect.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -121,13 +124,14 @@ module Google
         # @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_location_info_types(location_id, filter: nil, language_code: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/locations/{locationId}/infoTypes', options)
+        def list_location_info_types(parent, filter: nil, language_code: nil, location_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/infoTypes', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInfoTypesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInfoTypesResponse
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.params['parent'] = parent unless parent.nil?
           command.query['filter'] = filter unless filter.nil?
           command.query['languageCode'] = language_code unless language_code.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -247,8 +251,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where deidentifications templates will be retrieved
-        #   from. Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -445,8 +448,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where inspection templates will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -538,9 +540,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the deidentification template. Reserved
-        #   for future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -559,14 +558,13 @@ module Google
         # @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_organization_location_deidentify_template(parent, location_id, google_privacy_dlp_v2_create_deidentify_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/deidentifyTemplates', options)
+        def create_organization_location_deidentify_template(parent, google_privacy_dlp_v2_create_deidentify_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/deidentifyTemplates', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_deidentify_template_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -649,8 +647,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where deidentifications templates will be retrieved
-        #   from. Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -685,12 +682,12 @@ module Google
         # @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_organization_location_deidentify_templates(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/deidentifyTemplates', options)
+        def list_organization_location_deidentify_templates(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/deidentifyTemplates', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDeidentifyTemplatesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDeidentifyTemplatesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -743,9 +740,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the inspection template. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -764,14 +758,13 @@ module Google
         # @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_organization_location_inspect_template(parent, location_id, google_privacy_dlp_v2_create_inspect_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/inspectTemplates', options)
+        def create_organization_location_inspect_template(parent, google_privacy_dlp_v2_create_inspect_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/inspectTemplates', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_inspect_template_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -851,8 +844,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where inspection templates will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -887,12 +879,12 @@ module Google
         # @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_organization_location_inspect_templates(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/inspectTemplates', options)
+        def list_organization_location_inspect_templates(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/inspectTemplates', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInspectTemplatesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInspectTemplatesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -943,9 +935,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the stored infoType. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -964,14 +953,13 @@ module Google
         # @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_organization_location_stored_info_type(parent, location_id, google_privacy_dlp_v2_create_stored_info_type_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/storedInfoTypes', options)
+        def create_organization_location_stored_info_type(parent, google_privacy_dlp_v2_create_stored_info_type_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/storedInfoTypes', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_stored_info_type_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoType::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoType
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1053,8 +1041,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where stored infoTypes will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -1090,12 +1077,12 @@ module Google
         # @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_organization_location_stored_info_types(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/storedInfoTypes', options)
+        def list_organization_location_stored_info_types(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/storedInfoTypes', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListStoredInfoTypesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListStoredInfoTypesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -1254,8 +1241,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where stored infoTypes will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -1572,8 +1558,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where deidentifications templates will be retrieved
-        #   from. Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -1831,8 +1816,7 @@ module Google
         #   * end_time > \"2017-12-12T00:00:00+00:00\"
         #   The length of this field should be no more than 500 characters.
         # @param [String] location_id
-        #   The geographic location where jobs will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -2032,8 +2016,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where inspection templates will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -2277,8 +2260,7 @@ module Google
         #   * last_run_time > \"2017-12-12T00:00:00+00:00\"
         #   The length of this field should be no more than 500 characters.
         # @param [String] location_id
-        #   The geographic location where job triggers will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of triggeredJob fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -2374,9 +2356,6 @@ module Google
         # be all types, but may change over time as detectors are updated.
         # @param [String] parent
         #   The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location to process de-identification. Reserved for future
-        #   extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest] google_privacy_dlp_v2_deidentify_content_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2395,14 +2374,13 @@ module Google
         # @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 deidentify_project_location_content(parent, location_id, google_privacy_dlp_v2_deidentify_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/content:deidentify', options)
+        def deidentify_project_location_content(parent, google_privacy_dlp_v2_deidentify_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/content:deidentify', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest::Representation
           command.request_object = google_privacy_dlp_v2_deidentify_content_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2417,11 +2395,6 @@ module Google
         # and https://cloud.google.com/dlp/docs/inspecting-text,
         # @param [String] parent
         #   The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location to process content inspection. Reserved for future
-        #   extensions.
-        #   When inspecting images location is restricted to 'global', 'us', 'asia',
-        #   and 'europe'.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest] google_privacy_dlp_v2_inspect_content_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2440,14 +2413,13 @@ module Google
         # @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 inspect_project_location_content(parent, location_id, google_privacy_dlp_v2_inspect_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/content:inspect', options)
+        def inspect_project_location_content(parent, google_privacy_dlp_v2_inspect_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/content:inspect', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest::Representation
           command.request_object = google_privacy_dlp_v2_inspect_content_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2460,9 +2432,6 @@ module Google
         # to learn more.
         # @param [String] parent
         #   Required. The parent resource name.
-        # @param [String] location_id
-        #   The geographic location to process content reidentification.  Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest] google_privacy_dlp_v2_reidentify_content_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2481,14 +2450,13 @@ module Google
         # @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 reidentify_project_location_content(parent, location_id, google_privacy_dlp_v2_reidentify_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/content:reidentify', options)
+        def reidentify_project_location_content(parent, google_privacy_dlp_v2_reidentify_content_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/content:reidentify', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest::Representation
           command.request_object = google_privacy_dlp_v2_reidentify_content_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2501,9 +2469,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the deidentification template. Reserved
-        #   for future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2522,14 +2487,13 @@ module Google
         # @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_project_location_deidentify_template(parent, location_id, google_privacy_dlp_v2_create_deidentify_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/deidentifyTemplates', options)
+        def create_project_location_deidentify_template(parent, google_privacy_dlp_v2_create_deidentify_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/deidentifyTemplates', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_deidentify_template_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2612,8 +2576,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where deidentifications templates will be retrieved
-        #   from. Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -2648,12 +2611,12 @@ module Google
         # @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_project_location_deidentify_templates(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/deidentifyTemplates', options)
+        def list_project_location_deidentify_templates(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/deidentifyTemplates', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDeidentifyTemplatesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDeidentifyTemplatesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -2745,9 +2708,6 @@ module Google
         # be all types, but may change over time as detectors are updated.
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location to store and process the job. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest] google_privacy_dlp_v2_create_dlp_job_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2766,14 +2726,13 @@ module Google
         # @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_project_location_dlp_job(parent, location_id, google_privacy_dlp_v2_create_dlp_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/dlpJobs', options)
+        def create_project_location_dlp_job(parent, google_privacy_dlp_v2_create_dlp_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/dlpJobs', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_dlp_job_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2DlpJob::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2DlpJob
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2926,9 +2885,6 @@ module Google
         # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location where jobs will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
         # @param [String] filter
         #   Allows filtering.
         #   Supported syntax:
@@ -2953,6 +2909,8 @@ module Google
         #   * inspected_storage = cloud_storage AND (state = done OR state = canceled)
         #   * end_time > \"2017-12-12T00:00:00+00:00\"
         #   The length of this field should be no more than 500 characters.
+        # @param [String] location_id
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -2987,13 +2945,13 @@ module Google
         # @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_project_location_dlp_jobs(parent, location_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, type: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/dlpJobs', options)
+        def list_project_location_dlp_jobs(parent, filter: nil, location_id: nil, order_by: nil, page_size: nil, page_token: nil, type: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/dlpJobs', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDlpJobsResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListDlpJobsResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['filter'] = filter unless filter.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -3012,10 +2970,6 @@ module Google
         # be all types, but may change over time as detectors are updated.
         # @param [String] parent
         #   The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location to process the request. Reserved for future
-        #   extensions.
-        #   Location is restricted to 'global', 'us', 'asia', and 'europe'.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest] google_privacy_dlp_v2_redact_image_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3034,14 +2988,13 @@ module Google
         # @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 redact_project_location_image(parent, location_id, google_privacy_dlp_v2_redact_image_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/image:redact', options)
+        def redact_project_location_image(parent, google_privacy_dlp_v2_redact_image_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/image:redact', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest::Representation
           command.request_object = google_privacy_dlp_v2_redact_image_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -3053,9 +3006,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the inspection template. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3074,14 +3024,13 @@ module Google
         # @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_project_location_inspect_template(parent, location_id, google_privacy_dlp_v2_create_inspect_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/inspectTemplates', options)
+        def create_project_location_inspect_template(parent, google_privacy_dlp_v2_create_inspect_template_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/inspectTemplates', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_inspect_template_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -3161,8 +3110,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where inspection templates will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -3197,12 +3145,12 @@ module Google
         # @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_project_location_inspect_templates(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/inspectTemplates', options)
+        def list_project_location_inspect_templates(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/inspectTemplates', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInspectTemplatesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListInspectTemplatesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -3287,9 +3235,6 @@ module Google
         # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id.
-        # @param [String] location_id
-        #   The geographic location to store the job trigger. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest] google_privacy_dlp_v2_create_job_trigger_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3308,14 +3253,13 @@ module Google
         # @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_project_location_job_trigger(parent, location_id, google_privacy_dlp_v2_create_job_trigger_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/jobTriggers', options)
+        def create_project_location_job_trigger(parent, google_privacy_dlp_v2_create_job_trigger_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/jobTriggers', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_job_trigger_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2JobTrigger::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2JobTrigger
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -3429,9 +3373,6 @@ module Google
         # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
         # @param [String] parent
         #   Required. The parent resource name, for example `projects/my-project-id`.
-        # @param [String] location_id
-        #   The geographic location where job triggers will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
         # @param [String] filter
         #   Allows filtering.
         #   Supported syntax:
@@ -3452,6 +3393,8 @@ module Google
         #   * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
         #   * last_run_time > \"2017-12-12T00:00:00+00:00\"
         #   The length of this field should be no more than 500 characters.
+        # @param [String] location_id
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of triggeredJob fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -3488,13 +3431,13 @@ module Google
         # @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_project_location_job_triggers(parent, location_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/jobTriggers', options)
+        def list_project_location_job_triggers(parent, filter: nil, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/jobTriggers', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListJobTriggersResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListJobTriggersResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['filter'] = filter unless filter.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -3544,9 +3487,6 @@ module Google
         # @param [String] parent
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
-        # @param [String] location_id
-        #   The geographic location to store the stored infoType. Reserved for
-        #   future extensions.
         # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3565,14 +3505,13 @@ module Google
         # @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_project_location_stored_info_type(parent, location_id, google_privacy_dlp_v2_create_stored_info_type_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v2/{+parent}/locations/{locationId}/storedInfoTypes', options)
+        def create_project_location_stored_info_type(parent, google_privacy_dlp_v2_create_stored_info_type_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/storedInfoTypes', options)
           command.request_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest::Representation
           command.request_object = google_privacy_dlp_v2_create_stored_info_type_request_object
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoType::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoType
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -3654,8 +3593,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where stored infoTypes will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
@@ -3691,12 +3629,12 @@ module Google
         # @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_project_location_stored_info_types(parent, location_id, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+parent}/locations/{locationId}/storedInfoTypes', options)
+        def list_project_location_stored_info_types(parent, location_id: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/storedInfoTypes', options)
           command.response_representation = Google::Apis::DlpV2::GooglePrivacyDlpV2ListStoredInfoTypesResponse::Representation
           command.response_class = Google::Apis::DlpV2::GooglePrivacyDlpV2ListStoredInfoTypesResponse
           command.params['parent'] = parent unless parent.nil?
-          command.params['locationId'] = location_id unless location_id.nil?
+          command.query['locationId'] = location_id unless location_id.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -3855,8 +3793,7 @@ module Google
         #   Required. The parent resource name, for example projects/my-project-id or
         #   organizations/my-org-id.
         # @param [String] location_id
-        #   The geographic location where stored infoTypes will be retrieved from.
-        #   Use `-` for all locations. Reserved for future extensions.
+        #   Deprecated. This field has no effect.
         # @param [String] order_by
         #   Comma separated list of fields to order by,
         #   followed by `asc` or `desc` postfix. This list is case-insensitive,
diff --git a/generated/google/apis/securitycenter_v1.rb b/generated/google/apis/securitycenter_v1.rb
index be0501dd3..bf852d1b8 100644
--- a/generated/google/apis/securitycenter_v1.rb
+++ b/generated/google/apis/securitycenter_v1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
     module SecuritycenterV1
       VERSION = 'V1'
-      REVISION = '20200410'
+      REVISION = '20200519'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/securitycenter_v1/classes.rb b/generated/google/apis/securitycenter_v1/classes.rb
index 846067cf0..5ca00b582 100644
--- a/generated/google/apis/securitycenter_v1/classes.rb
+++ b/generated/google/apis/securitycenter_v1/classes.rb
@@ -531,6 +531,9 @@ module Google
         # Requests for policies with any conditional bindings must specify version 3.
         # Policies without any conditional bindings may specify any valid value or
         # leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM
+        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -1795,10 +1798,13 @@ module Google
       # Google groups, and domains (such as G Suite). A `role` is a named list of
       # permissions; each `role` can be an IAM predefined role or a user-created
       # custom role.
-      # Optionally, a `binding` can specify a `condition`, which is a logical
-      # expression that allows access to a resource only if the expression evaluates
-      # to `true`. A condition can add constraints based on attributes of the
-      # request, the resource, or both.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
       # **JSON example:**
       # `
       # "bindings": [
@@ -1813,7 +1819,9 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
@@ -1891,6 +1899,9 @@ module Google
         # the conditions in the version `3` policy are lost.
         # If a policy does not include any conditions, operations on that policy may
         # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2110,10 +2121,13 @@ module Google
         # Google groups, and domains (such as G Suite). A `role` is a named list of
         # permissions; each `role` can be an IAM predefined role or a user-created
         # custom role.
-        # Optionally, a `binding` can specify a `condition`, which is a logical
-        # expression that allows access to a resource only if the expression evaluates
-        # to `true`. A condition can add constraints based on attributes of the
-        # request, the resource, or both.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # **JSON example:**
         # `
         # "bindings": [
@@ -2128,7 +2142,9 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
@@ -2166,8 +2182,7 @@ module Google
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
         # the fields in the mask will be modified. If no mask is provided, the
         # following default mask is used:
-        # paths: "bindings, etag"
-        # This field is only used by Cloud IAM.
+        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
diff --git a/generated/google/apis/securitycenter_v1beta1.rb b/generated/google/apis/securitycenter_v1beta1.rb
index dc00a0c82..08c8830d2 100644
--- a/generated/google/apis/securitycenter_v1beta1.rb
+++ b/generated/google/apis/securitycenter_v1beta1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
     module SecuritycenterV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200410'
+      REVISION = '20200519'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/securitycenter_v1beta1/classes.rb b/generated/google/apis/securitycenter_v1beta1/classes.rb
index 157d49ebd..a153f65a5 100644
--- a/generated/google/apis/securitycenter_v1beta1/classes.rb
+++ b/generated/google/apis/securitycenter_v1beta1/classes.rb
@@ -535,6 +535,9 @@ module Google
         # Requests for policies with any conditional bindings must specify version 3.
         # Policies without any conditional bindings may specify any valid value or
         # leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM
+        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -1703,10 +1706,13 @@ module Google
       # Google groups, and domains (such as G Suite). A `role` is a named list of
       # permissions; each `role` can be an IAM predefined role or a user-created
       # custom role.
-      # Optionally, a `binding` can specify a `condition`, which is a logical
-      # expression that allows access to a resource only if the expression evaluates
-      # to `true`. A condition can add constraints based on attributes of the
-      # request, the resource, or both.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
       # **JSON example:**
       # `
       # "bindings": [
@@ -1721,7 +1727,9 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
@@ -1799,6 +1807,9 @@ module Google
         # the conditions in the version `3` policy are lost.
         # If a policy does not include any conditions, operations on that policy may
         # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -1955,10 +1966,13 @@ module Google
         # Google groups, and domains (such as G Suite). A `role` is a named list of
         # permissions; each `role` can be an IAM predefined role or a user-created
         # custom role.
-        # Optionally, a `binding` can specify a `condition`, which is a logical
-        # expression that allows access to a resource only if the expression evaluates
-        # to `true`. A condition can add constraints based on attributes of the
-        # request, the resource, or both.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # **JSON example:**
         # `
         # "bindings": [
@@ -1973,7 +1987,9 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
@@ -2011,8 +2027,7 @@ module Google
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
         # the fields in the mask will be modified. If no mask is provided, the
         # following default mask is used:
-        # paths: "bindings, etag"
-        # This field is only used by Cloud IAM.
+        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
diff --git a/generated/google/apis/securitycenter_v1p1beta1.rb b/generated/google/apis/securitycenter_v1p1beta1.rb
index 94b8581ef..75734dd42 100644
--- a/generated/google/apis/securitycenter_v1p1beta1.rb
+++ b/generated/google/apis/securitycenter_v1p1beta1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
     module SecuritycenterV1p1beta1
       VERSION = 'V1p1beta1'
-      REVISION = '20200410'
+      REVISION = '20200519'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/securitycenter_v1p1beta1/classes.rb b/generated/google/apis/securitycenter_v1p1beta1/classes.rb
index e89ac76e3..c2a51b305 100644
--- a/generated/google/apis/securitycenter_v1p1beta1/classes.rb
+++ b/generated/google/apis/securitycenter_v1p1beta1/classes.rb
@@ -459,6 +459,9 @@ module Google
         # Requests for policies with any conditional bindings must specify version 3.
         # Policies without any conditional bindings may specify any valid value or
         # leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM
+        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -1705,10 +1708,13 @@ module Google
       # Google groups, and domains (such as G Suite). A `role` is a named list of
       # permissions; each `role` can be an IAM predefined role or a user-created
       # custom role.
-      # Optionally, a `binding` can specify a `condition`, which is a logical
-      # expression that allows access to a resource only if the expression evaluates
-      # to `true`. A condition can add constraints based on attributes of the
-      # request, the resource, or both.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
       # **JSON example:**
       # `
       # "bindings": [
@@ -1723,7 +1729,9 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
@@ -1801,6 +1809,9 @@ module Google
         # the conditions in the version `3` policy are lost.
         # If a policy does not include any conditions, operations on that policy may
         # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -1951,10 +1962,13 @@ module Google
         # Google groups, and domains (such as G Suite). A `role` is a named list of
         # permissions; each `role` can be an IAM predefined role or a user-created
         # custom role.
-        # Optionally, a `binding` can specify a `condition`, which is a logical
-        # expression that allows access to a resource only if the expression evaluates
-        # to `true`. A condition can add constraints based on attributes of the
-        # request, the resource, or both.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # **JSON example:**
         # `
         # "bindings": [
@@ -1969,7 +1983,9 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
@@ -2007,8 +2023,7 @@ module Google
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
         # the fields in the mask will be modified. If no mask is provided, the
         # following default mask is used:
-        # paths: "bindings, etag"
-        # This field is only used by Cloud IAM.
+        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
diff --git a/generated/google/apis/servicenetworking_v1.rb b/generated/google/apis/servicenetworking_v1.rb
index 98561b56f..1f00b4453 100644
--- a/generated/google/apis/servicenetworking_v1.rb
+++ b/generated/google/apis/servicenetworking_v1.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
     module ServicenetworkingV1
       VERSION = 'V1'
-      REVISION = '20200516'
+      REVISION = '20200519'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/servicenetworking_v1/classes.rb b/generated/google/apis/servicenetworking_v1/classes.rb
index 3e6c514b4..ddc7edc02 100644
--- a/generated/google/apis/servicenetworking_v1/classes.rb
+++ b/generated/google/apis/servicenetworking_v1/classes.rb
@@ -22,6 +22,137 @@ module Google
   module Apis
     module ServicenetworkingV1
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # AddDnsRecordSet API
+      class AddDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request to add a record set to a private managed DNS zone in the shared
+      # producer host project.
+      class AddDnsRecordSetRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The network that the consumer is using to connect with services.
+        # Must be in the form of projects/`project`/global/networks/`network`
+        # `project` is the project number, as in '12345'
+        # `network` is the network name.
+        # Corresponds to the JSON property `consumerNetwork`
+        # @return [String]
+        attr_accessor :consumer_network
+      
+        # Represents a DNS record set resource.
+        # Corresponds to the JSON property `dnsRecordSet`
+        # @return [Google::Apis::ServicenetworkingV1::DnsRecordSet]
+        attr_accessor :dns_record_set
+      
+        # Required. The name of the private DNS zone in the shared producer host project
+        # to
+        # which the record set will be added.
+        # Corresponds to the JSON property `zone`
+        # @return [String]
+        attr_accessor :zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
+          @dns_record_set = args[:dns_record_set] if args.key?(:dns_record_set)
+          @zone = args[:zone] if args.key?(:zone)
+        end
+      end
+      
+      # Metadata provided through GetOperation request for the LRO generated by
+      # AddDnsZone API
+      class AddDnsZoneMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request to add a private managed DNS zone in the shared producer host project
+      # and a matching DNS peering zone in the consumer project.
+      class AddDnsZoneRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The network that the consumer is using to connect with services.
+        # Must be in the form of projects/`project`/global/networks/`network`
+        # `project` is the project number, as in '12345'
+        # `network` is the network name.
+        # Corresponds to the JSON property `consumerNetwork`
+        # @return [String]
+        attr_accessor :consumer_network
+      
+        # Required. The DNS name suffix for the zones e.g. `example.com`.
+        # Corresponds to the JSON property `dnsSuffix`
+        # @return [String]
+        attr_accessor :dns_suffix
+      
+        # Required. The name for both the private zone in the shared producer host
+        # project and
+        # the peering zone in the consumer project. Must be unique within both
+        # projects. The name must be 1-63 characters long, must begin with a letter,
+        # end with a letter or digit, and only contain lowercase letters, digits or
+        # dashes.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
+          @dns_suffix = args[:dns_suffix] if args.key?(:dns_suffix)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Represents managed DNS zones created in the shared producer host and consumer
+      # projects.
+      class AddDnsZoneResponse
+        include Google::Apis::Core::Hashable
+      
+        # Represents a DNS zone resource.
+        # Corresponds to the JSON property `consumerPeeringZone`
+        # @return [Google::Apis::ServicenetworkingV1::DnsZone]
+        attr_accessor :consumer_peering_zone
+      
+        # Represents a DNS zone resource.
+        # Corresponds to the JSON property `producerPrivateZone`
+        # @return [Google::Apis::ServicenetworkingV1::DnsZone]
+        attr_accessor :producer_private_zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_peering_zone = args[:consumer_peering_zone] if args.key?(:consumer_peering_zone)
+          @producer_private_zone = args[:producer_private_zone] if args.key?(:producer_private_zone)
+        end
+      end
+      
       # Metadata provided through GetOperation request for the LRO generated by
       # AddRoles API
       class AddRolesMetadata
@@ -1011,6 +1142,72 @@ module Google
         end
       end
       
+      # Represents a DNS record set resource.
+      class DnsRecordSet
+        include Google::Apis::Core::Hashable
+      
+        # Required. As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) for
+        # examples see https://cloud.google.com/dns/records/json-record.
+        # Corresponds to the JSON property `data`
+        # @return [Array<String>]
+        attr_accessor :data
+      
+        # Required. The DNS or domain name of the record set, e.g. `test.example.com`.
+        # Corresponds to the JSON property `domain`
+        # @return [String]
+        attr_accessor :domain
+      
+        # Required. The period of time for which this RecordSet can be cached by
+        # resolvers.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        # Required. The identifier of a supported record type.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @domain = args[:domain] if args.key?(:domain)
+          @ttl = args[:ttl] if args.key?(:ttl)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # Represents a DNS zone resource.
+      class DnsZone
+        include Google::Apis::Core::Hashable
+      
+        # The DNS name suffix of this zone e.g. `example.com.`.
+        # Corresponds to the JSON property `dnsSuffix`
+        # @return [String]
+        attr_accessor :dns_suffix
+      
+        # User assigned name for this resource. Must be unique within the project.
+        # The name must be 1-63 characters long, must begin with a letter, end with
+        # a letter or digit, and only contain lowercase letters, digits or dashes.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dns_suffix = args[:dns_suffix] if args.key?(:dns_suffix)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # `Documentation` provides the information for describing a service.
       # Example:
       # <pre><code>documentation:
@@ -3074,6 +3271,129 @@ module Google
         end
       end
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # RemoveDnsRecordSet API
+      class RemoveDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request to remove a record set from a private managed DNS zone in the shared
+      # producer host project. The name, type, ttl, and data values must all exactly
+      # match an existing record set in the specified zone.
+      class RemoveDnsRecordSetRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The network that the consumer is using to connect with services.
+        # Must be in the form of projects/`project`/global/networks/`network`
+        # `project` is the project number, as in '12345'
+        # `network` is the network name.
+        # Corresponds to the JSON property `consumerNetwork`
+        # @return [String]
+        attr_accessor :consumer_network
+      
+        # Represents a DNS record set resource.
+        # Corresponds to the JSON property `dnsRecordSet`
+        # @return [Google::Apis::ServicenetworkingV1::DnsRecordSet]
+        attr_accessor :dns_record_set
+      
+        # Required. The name of the private DNS zone in the shared producer host project
+        # from
+        # which the record set will be removed.
+        # Corresponds to the JSON property `zone`
+        # @return [String]
+        attr_accessor :zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
+          @dns_record_set = args[:dns_record_set] if args.key?(:dns_record_set)
+          @zone = args[:zone] if args.key?(:zone)
+        end
+      end
+      
+      # Blank message response type for RemoveDnsRecordSet API
+      class RemoveDnsRecordSetResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Metadata provided through GetOperation request for the LRO generated by
+      # RemoveDnsZone API
+      class RemoveDnsZoneMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request to remove a private managed DNS zone in the shared producer host
+      # project and a matching DNS peering zone in the consumer project.
+      class RemoveDnsZoneRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The network that the consumer is using to connect with services.
+        # Must be in the form of projects/`project`/global/networks/`network`
+        # `project` is the project number, as in '12345'
+        # `network` is the network name.
+        # Corresponds to the JSON property `consumerNetwork`
+        # @return [String]
+        attr_accessor :consumer_network
+      
+        # Required. The name for both the private zone in the shared producer host
+        # project and
+        # the peering zone in the consumer project.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Blank message response type for RemoveDnsZone API
+      class RemoveDnsZoneResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Represents a route that was created or discovered by a private access
       # management service.
       class Route
@@ -3928,6 +4248,65 @@ module Google
         end
       end
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # UpdateDnsRecordSet API
+      class UpdateDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request to update a record set from a private managed DNS zone in the shared
+      # producer host project. The name, type, ttl, and data values of the existing
+      # record set must all exactly match an existing record set in the specified
+      # zone.
+      class UpdateDnsRecordSetRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The network that the consumer is using to connect with services.
+        # Must be in the form of projects/`project`/global/networks/`network`
+        # `project` is the project number, as in '12345'
+        # `network` is the network name.
+        # Corresponds to the JSON property `consumerNetwork`
+        # @return [String]
+        attr_accessor :consumer_network
+      
+        # Represents a DNS record set resource.
+        # Corresponds to the JSON property `existingDnsRecordSet`
+        # @return [Google::Apis::ServicenetworkingV1::DnsRecordSet]
+        attr_accessor :existing_dns_record_set
+      
+        # Represents a DNS record set resource.
+        # Corresponds to the JSON property `newDnsRecordSet`
+        # @return [Google::Apis::ServicenetworkingV1::DnsRecordSet]
+        attr_accessor :new_dns_record_set
+      
+        # Required. The name of the private DNS zone in the shared producer host project
+        # from
+        # which the record set will be removed.
+        # Corresponds to the JSON property `zone`
+        # @return [String]
+        attr_accessor :zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
+          @existing_dns_record_set = args[:existing_dns_record_set] if args.key?(:existing_dns_record_set)
+          @new_dns_record_set = args[:new_dns_record_set] if args.key?(:new_dns_record_set)
+          @zone = args[:zone] if args.key?(:zone)
+        end
+      end
+      
       # Configuration controlling usage of a service.
       class Usage
         include Google::Apis::Core::Hashable
diff --git a/generated/google/apis/servicenetworking_v1/representations.rb b/generated/google/apis/servicenetworking_v1/representations.rb
index f9341e6b8..5e4a77d1b 100644
--- a/generated/google/apis/servicenetworking_v1/representations.rb
+++ b/generated/google/apis/servicenetworking_v1/representations.rb
@@ -22,6 +22,36 @@ module Google
   module Apis
     module ServicenetworkingV1
       
+      class AddDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsRecordSetRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsZoneMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsZoneRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsZoneResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AddRolesMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -160,6 +190,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DnsRecordSet
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DnsZone
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Documentation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -370,6 +412,42 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RemoveDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsRecordSetRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsRecordSetResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsZoneMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsZoneRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsZoneResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Route
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -442,6 +520,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpdateDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UpdateDnsRecordSetRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Usage
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -466,6 +556,47 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AddDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class AddDnsRecordSetRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_network, as: 'consumerNetwork'
+          property :dns_record_set, as: 'dnsRecordSet', class: Google::Apis::ServicenetworkingV1::DnsRecordSet, decorator: Google::Apis::ServicenetworkingV1::DnsRecordSet::Representation
+      
+          property :zone, as: 'zone'
+        end
+      end
+      
+      class AddDnsZoneMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class AddDnsZoneRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_network, as: 'consumerNetwork'
+          property :dns_suffix, as: 'dnsSuffix'
+          property :name, as: 'name'
+        end
+      end
+      
+      class AddDnsZoneResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_peering_zone, as: 'consumerPeeringZone', class: Google::Apis::ServicenetworkingV1::DnsZone, decorator: Google::Apis::ServicenetworkingV1::DnsZone::Representation
+      
+          property :producer_private_zone, as: 'producerPrivateZone', class: Google::Apis::ServicenetworkingV1::DnsZone, decorator: Google::Apis::ServicenetworkingV1::DnsZone::Representation
+      
+        end
+      end
+      
       class AddRolesMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -684,6 +815,24 @@ module Google
         end
       end
       
+      class DnsRecordSet
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :data, as: 'data'
+          property :domain, as: 'domain'
+          property :ttl, as: 'ttl'
+          property :type, as: 'type'
+        end
+      end
+      
+      class DnsZone
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :dns_suffix, as: 'dnsSuffix'
+          property :name, as: 'name'
+        end
+      end
+      
       class Documentation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1050,6 +1199,48 @@ module Google
         end
       end
       
+      class RemoveDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsRecordSetRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_network, as: 'consumerNetwork'
+          property :dns_record_set, as: 'dnsRecordSet', class: Google::Apis::ServicenetworkingV1::DnsRecordSet, decorator: Google::Apis::ServicenetworkingV1::DnsRecordSet::Representation
+      
+          property :zone, as: 'zone'
+        end
+      end
+      
+      class RemoveDnsRecordSetResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsZoneMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsZoneRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_network, as: 'consumerNetwork'
+          property :name, as: 'name'
+        end
+      end
+      
+      class RemoveDnsZoneResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Route
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1206,6 +1397,24 @@ module Google
         end
       end
       
+      class UpdateDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class UpdateDnsRecordSetRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_network, as: 'consumerNetwork'
+          property :existing_dns_record_set, as: 'existingDnsRecordSet', class: Google::Apis::ServicenetworkingV1::DnsRecordSet, decorator: Google::Apis::ServicenetworkingV1::DnsRecordSet::Representation
+      
+          property :new_dns_record_set, as: 'newDnsRecordSet', class: Google::Apis::ServicenetworkingV1::DnsRecordSet, decorator: Google::Apis::ServicenetworkingV1::DnsRecordSet::Representation
+      
+          property :zone, as: 'zone'
+        end
+      end
+      
       class Usage
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
diff --git a/generated/google/apis/servicenetworking_v1/service.rb b/generated/google/apis/servicenetworking_v1/service.rb
index 1e76f3aa6..9a518eb5b 100644
--- a/generated/google/apis/servicenetworking_v1/service.rb
+++ b/generated/google/apis/servicenetworking_v1/service.rb
@@ -530,6 +530,193 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Service producers can use this method to add DNS record sets to private DNS
+        # zones in the shared producer host project.
+        # @param [String] parent
+        #   Required. The service that is managing peering connectivity for a service
+        #   producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::AddDnsRecordSetRequest] add_dns_record_set_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @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 add_dns_record_set(parent, add_dns_record_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/dnsRecordSets:add', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::AddDnsRecordSetRequest::Representation
+          command.request_object = add_dns_record_set_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Service producers can use this method to remove DNS record sets from
+        # private DNS zones in the shared producer host project.
+        # @param [String] parent
+        #   Required. The service that is managing peering connectivity for a service
+        #   producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::RemoveDnsRecordSetRequest] remove_dns_record_set_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @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 remove_dns_record_set(parent, remove_dns_record_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/dnsRecordSets:remove', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::RemoveDnsRecordSetRequest::Representation
+          command.request_object = remove_dns_record_set_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Service producers can use this method to update DNS record sets from
+        # private DNS zones in the shared producer host project.
+        # @param [String] parent
+        #   Required. The service that is managing peering connectivity for a service
+        #   producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::UpdateDnsRecordSetRequest] update_dns_record_set_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @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 update_dns_record_set(parent, update_dns_record_set_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/dnsRecordSets:update', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::UpdateDnsRecordSetRequest::Representation
+          command.request_object = update_dns_record_set_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Service producers can use this method to add private DNS zones in the
+        # shared producer host project and matching peering zones in the consumer
+        # project.
+        # @param [String] parent
+        #   Required. The service that is managing peering connectivity for a service
+        #   producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::AddDnsZoneRequest] add_dns_zone_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @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 add_dns_zone(parent, add_dns_zone_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/dnsZones:add', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::AddDnsZoneRequest::Representation
+          command.request_object = add_dns_zone_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Service producers can use this method to remove private DNS zones in the
+        # shared producer host project and matching peering zones in the consumer
+        # project.
+        # @param [String] parent
+        #   Required. The service that is managing peering connectivity for a service
+        #   producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::RemoveDnsZoneRequest] remove_dns_zone_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @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 remove_dns_zone(parent, remove_dns_zone_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/dnsZones:remove', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::RemoveDnsZoneRequest::Representation
+          command.request_object = remove_dns_zone_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Service producers can use this method to add roles in the shared VPC host
         # project. Each role is bound to the provided member. Each role must be
         # selected from within a whitelisted set of roles. Each role is applied at
diff --git a/generated/google/apis/servicenetworking_v1beta.rb b/generated/google/apis/servicenetworking_v1beta.rb
index 4db592587..7dc124547 100644
--- a/generated/google/apis/servicenetworking_v1beta.rb
+++ b/generated/google/apis/servicenetworking_v1beta.rb
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
     module ServicenetworkingV1beta
       VERSION = 'V1beta'
-      REVISION = '20200516'
+      REVISION = '20200519'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
diff --git a/generated/google/apis/servicenetworking_v1beta/classes.rb b/generated/google/apis/servicenetworking_v1beta/classes.rb
index 1ac631470..f94869ead 100644
--- a/generated/google/apis/servicenetworking_v1beta/classes.rb
+++ b/generated/google/apis/servicenetworking_v1beta/classes.rb
@@ -22,6 +22,60 @@ module Google
   module Apis
     module ServicenetworkingV1beta
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # AddDnsRecordSet API
+      class AddDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Metadata provided through GetOperation request for the LRO generated by
+      # AddDnsZone API
+      class AddDnsZoneMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Represents managed DNS zones created in the shared producer host and consumer
+      # projects.
+      class AddDnsZoneResponse
+        include Google::Apis::Core::Hashable
+      
+        # Represents a DNS zone resource.
+        # Corresponds to the JSON property `consumerPeeringZone`
+        # @return [Google::Apis::ServicenetworkingV1beta::DnsZone]
+        attr_accessor :consumer_peering_zone
+      
+        # Represents a DNS zone resource.
+        # Corresponds to the JSON property `producerPrivateZone`
+        # @return [Google::Apis::ServicenetworkingV1beta::DnsZone]
+        attr_accessor :producer_private_zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_peering_zone = args[:consumer_peering_zone] if args.key?(:consumer_peering_zone)
+          @producer_private_zone = args[:producer_private_zone] if args.key?(:producer_private_zone)
+        end
+      end
+      
       # Metadata provided through GetOperation request for the LRO generated by
       # AddRoles API
       class AddRolesMetadata
@@ -912,6 +966,72 @@ module Google
         end
       end
       
+      # Represents a DNS record set resource.
+      class DnsRecordSet
+        include Google::Apis::Core::Hashable
+      
+        # Required. As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) for
+        # examples see https://cloud.google.com/dns/records/json-record.
+        # Corresponds to the JSON property `data`
+        # @return [Array<String>]
+        attr_accessor :data
+      
+        # Required. The DNS or domain name of the record set, e.g. `test.example.com`.
+        # Corresponds to the JSON property `domain`
+        # @return [String]
+        attr_accessor :domain
+      
+        # Required. The period of time for which this RecordSet can be cached by
+        # resolvers.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        # Required. The identifier of a supported record type.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @domain = args[:domain] if args.key?(:domain)
+          @ttl = args[:ttl] if args.key?(:ttl)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # Represents a DNS zone resource.
+      class DnsZone
+        include Google::Apis::Core::Hashable
+      
+        # The DNS name suffix of this zone e.g. `example.com.`.
+        # Corresponds to the JSON property `dnsSuffix`
+        # @return [String]
+        attr_accessor :dns_suffix
+      
+        # User assigned name for this resource. Must be unique within the project.
+        # The name must be 1-63 characters long, must begin with a letter, end with
+        # a letter or digit, and only contain lowercase letters, digits or dashes.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dns_suffix = args[:dns_suffix] if args.key?(:dns_suffix)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # `Documentation` provides the information for describing a service.
       # Example:
       # <pre><code>documentation:
@@ -2876,6 +2996,60 @@ module Google
         end
       end
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # RemoveDnsRecordSet API
+      class RemoveDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Blank message response type for RemoveDnsRecordSet API
+      class RemoveDnsRecordSetResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Metadata provided through GetOperation request for the LRO generated by
+      # RemoveDnsZone API
+      class RemoveDnsZoneMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Blank message response type for RemoveDnsZone API
+      class RemoveDnsZoneResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Represents a route that was created or discovered by a private access
       # management service.
       class Route
@@ -3732,6 +3906,20 @@ module Google
         end
       end
       
+      # Metadata provided through GetOperation request for the LRO generated by
+      # UpdateDnsRecordSet API
+      class UpdateDnsRecordSetMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Configuration controlling usage of a service.
       class Usage
         include Google::Apis::Core::Hashable
diff --git a/generated/google/apis/servicenetworking_v1beta/representations.rb b/generated/google/apis/servicenetworking_v1beta/representations.rb
index 1bd5d0e50..acca34824 100644
--- a/generated/google/apis/servicenetworking_v1beta/representations.rb
+++ b/generated/google/apis/servicenetworking_v1beta/representations.rb
@@ -22,6 +22,24 @@ module Google
   module Apis
     module ServicenetworkingV1beta
       
+      class AddDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsZoneMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDnsZoneResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AddRolesMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -136,6 +154,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DnsRecordSet
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DnsZone
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Documentation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -322,6 +352,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RemoveDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsRecordSetResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsZoneMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemoveDnsZoneResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Route
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -394,6 +448,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpdateDnsRecordSetMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Usage
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -406,6 +466,28 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AddDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class AddDnsZoneMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class AddDnsZoneResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_peering_zone, as: 'consumerPeeringZone', class: Google::Apis::ServicenetworkingV1beta::DnsZone, decorator: Google::Apis::ServicenetworkingV1beta::DnsZone::Representation
+      
+          property :producer_private_zone, as: 'producerPrivateZone', class: Google::Apis::ServicenetworkingV1beta::DnsZone, decorator: Google::Apis::ServicenetworkingV1beta::DnsZone::Representation
+      
+        end
+      end
+      
       class AddRolesMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -594,6 +676,24 @@ module Google
         end
       end
       
+      class DnsRecordSet
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :data, as: 'data'
+          property :domain, as: 'domain'
+          property :ttl, as: 'ttl'
+          property :type, as: 'type'
+        end
+      end
+      
+      class DnsZone
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :dns_suffix, as: 'dnsSuffix'
+          property :name, as: 'name'
+        end
+      end
+      
       class Documentation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -930,6 +1030,30 @@ module Google
         end
       end
       
+      class RemoveDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsRecordSetResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsZoneMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class RemoveDnsZoneResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Route
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1086,6 +1210,12 @@ module Google
         end
       end
       
+      class UpdateDnsRecordSetMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Usage
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
diff --git a/generated/google/apis/tasks_v1.rb b/generated/google/apis/tasks_v1.rb
index c90011f3f..c04a1c33e 100644
--- a/generated/google/apis/tasks_v1.rb
+++ b/generated/google/apis/tasks_v1.rb
@@ -20,12 +20,12 @@ module Google
   module Apis
     # Tasks API
     #
-    # Manages your tasks and task lists.
+    # The Google Tasks API lets you manage your tasks and task lists.
     #
-    # @see https://developers.google.com/google-apps/tasks/firstapp
+    # @see 
     module TasksV1
       VERSION = 'V1'
-      REVISION = '20200129'
+      REVISION = '20200516'
 
       # Create, edit, organize, and delete all your tasks
       AUTH_TASKS = 'https://www.googleapis.com/auth/tasks'
diff --git a/generated/google/apis/tasks_v1/classes.rb b/generated/google/apis/tasks_v1/classes.rb
index aeab3ba8c..5514ffde6 100644
--- a/generated/google/apis/tasks_v1/classes.rb
+++ b/generated/google/apis/tasks_v1/classes.rb
@@ -26,24 +26,24 @@ module Google
       class Task
         include Google::Apis::Core::Hashable
       
-        # Completion date of the task (as a RFC 3339 timestamp). This field is omitted
-        # if the task has not been completed.
+        # Completion date of the task (as a RFC 3339 timestamp). This field is
+        # omitted if the task has not been completed.
         # Corresponds to the JSON property `completed`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :completed
       
-        # Flag indicating whether the task has been deleted. The default if False.
+        # Flag indicating whether the task has been deleted. The default is False.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
         # Due date of the task (as a RFC 3339 timestamp). Optional. The due date only
-        # records date information; the time portion of the timestamp is discarded when
-        # setting the due date. It isn't possible to read or write the time that a task
-        # is due via the API.
+        # records date information; the time portion of the timestamp is discarded
+        # when setting the due date. It isn't possible to read or write the time that
+        # a task is due via the API.
         # Corresponds to the JSON property `due`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :due
       
         # ETag of the resource.
@@ -51,9 +51,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Flag indicating whether the task is hidden. This is the case if the task had
-        # been marked completed when the task list was last cleared. The default is
-        # False. This field is read-only.
+        # Flag indicating whether the task is hidden. This is the case if the task
+        # had been marked completed when the task list was last cleared. The default
+        # is False. This field is read-only.
         # Corresponds to the JSON property `hidden`
         # @return [Boolean]
         attr_accessor :hidden
@@ -79,19 +79,19 @@ module Google
         # @return [String]
         attr_accessor :notes
       
-        # Parent task identifier. This field is omitted if it is a top-level task. This
-        # field is read-only. Use the "move" method to move the task under a different
-        # parent or to the top level.
+        # Parent task identifier. This field is omitted if it is a top-level task.
+        # This field is read-only. Use the "move" method to move the task under a
+        # different parent or to the top level.
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
       
-        # String indicating the position of the task among its sibling tasks under the
-        # same parent task or at the top level. If this string is greater than another
-        # task's corresponding position string according to lexicographical ordering,
-        # the task is positioned after the other task under the same parent task (or at
-        # the top level). This field is read-only. Use the "move" method to move the
-        # task to another position.
+        # String indicating the position of the task among its sibling tasks under
+        # the same parent task or at the top level. If this string is greater than
+        # another task's corresponding position string according to lexicographical
+        # ordering, the task is positioned after the other task under the same parent
+        # task (or at the top level). This field is read-only. Use the "move" method
+        # to move the task to another position.
         # Corresponds to the JSON property `position`
         # @return [String]
         attr_accessor :position
@@ -113,7 +113,7 @@ module Google
       
         # Last modification time of the task (as a RFC 3339 timestamp).
         # Corresponds to the JSON property `updated`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :updated
       
         def initialize(**args)
@@ -143,7 +143,8 @@ module Google
         class Link
           include Google::Apis::Core::Hashable
         
-          # The description. In HTML speak: Everything between <a> and </a>.
+          # The description. In HTML speak: Everything between &lt;a&gt; and
+          # &lt;/a&gt;.
           # Corresponds to the JSON property `description`
           # @return [String]
           attr_accessor :description
@@ -190,8 +191,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # URL pointing to this task list. Used to retrieve, update, or delete this task
-        # list.
+        # URL pointing to this task list. Used to retrieve, update, or delete this
+        # task list.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -203,7 +204,7 @@ module Google
       
         # Last modification time of the task list (as a RFC 3339 timestamp).
         # Corresponds to the JSON property `updated`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :updated
       
         def initialize(**args)
diff --git a/generated/google/apis/tasks_v1/representations.rb b/generated/google/apis/tasks_v1/representations.rb
index 955e9bcee..713f3d8eb 100644
--- a/generated/google/apis/tasks_v1/representations.rb
+++ b/generated/google/apis/tasks_v1/representations.rb
@@ -55,11 +55,9 @@ module Google
       class Task
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :completed, as: 'completed', type: DateTime
-      
+          property :completed, as: 'completed'
           property :deleted, as: 'deleted'
-          property :due, as: 'due', type: DateTime
-      
+          property :due, as: 'due'
           property :etag, as: 'etag'
           property :hidden, as: 'hidden'
           property :id, as: 'id'
@@ -72,8 +70,7 @@ module Google
           property :self_link, as: 'selfLink'
           property :status, as: 'status'
           property :title, as: 'title'
-          property :updated, as: 'updated', type: DateTime
-      
+          property :updated, as: 'updated'
         end
         
         class Link
@@ -94,8 +91,7 @@ module Google
           property :kind, as: 'kind'
           property :self_link, as: 'selfLink'
           property :title, as: 'title'
-          property :updated, as: 'updated', type: DateTime
-      
+          property :updated, as: 'updated'
         end
       end
       
diff --git a/generated/google/apis/tasks_v1/service.rb b/generated/google/apis/tasks_v1/service.rb
index ffd440020..b9a29df3d 100644
--- a/generated/google/apis/tasks_v1/service.rb
+++ b/generated/google/apis/tasks_v1/service.rb
@@ -22,7 +22,7 @@ module Google
     module TasksV1
       # Tasks API
       #
-      # Manages your tasks and task lists.
+      # The Google Tasks API lets you manage your tasks and task lists.
       #
       # @example
       #    require 'google/apis/tasks_v1'
@@ -30,7 +30,7 @@ module Google
       #    Tasks = Google::Apis::TasksV1 # Alias the module
       #    service = Tasks::TasksService.new
       #
-      # @see https://developers.google.com/google-apps/tasks/firstapp
+      # @see 
       class TasksService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -38,16 +38,12 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  An opaque string that represents a user for quota purposes. Must not exceed 40
-        #  characters.
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
         attr_accessor :quota_user
 
-        # @return [String]
-        #  Deprecated. Please use quotaUser instead.
-        attr_accessor :user_ip
-
         def initialize
-          super('https://www.googleapis.com/', 'tasks/v1/')
+          super('https://www.googleapis.com/', '')
           @batch_path = 'batch/tasks/v1'
         end
         
@@ -57,10 +53,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -73,12 +67,11 @@ module Google
         # @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 delete_tasklist(tasklist, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'users/@me/lists/{tasklist}', options)
+        def delete_tasklist(tasklist, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'tasks/v1/users/@me/lists/{tasklist}', options)
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -88,10 +81,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -104,28 +95,23 @@ module Google
         # @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_tasklist(tasklist, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'users/@me/lists/{tasklist}', options)
+        def get_tasklist(tasklist, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'tasks/v1/users/@me/lists/{tasklist}', options)
           command.response_representation = Google::Apis::TasksV1::TaskList::Representation
           command.response_class = Google::Apis::TasksV1::TaskList
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Creates a new task list and adds it to the authenticated user's task lists.
-        # Fails with HTTP code 403 or 429 after reaching the storage limit of 2,000
-        # lists.
         # @param [Google::Apis::TasksV1::TaskList] task_list_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -138,31 +124,28 @@ module Google
         # @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 insert_tasklist(task_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'users/@me/lists', options)
+        def insert_tasklist(task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'tasks/v1/users/@me/lists', options)
           command.request_representation = Google::Apis::TasksV1::TaskList::Representation
           command.request_object = task_list_object
           command.response_representation = Google::Apis::TasksV1::TaskList::Representation
           command.response_class = Google::Apis::TasksV1::TaskList
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Returns all the authenticated user's task lists.
         # @param [Fixnum] max_results
-        #   Maximum number of task lists returned on one page. Optional. The default is 20
-        #   (max allowed: 100).
+        #   Maximum number of task lists returned on one page. Optional. The default is
+        #   20 (max allowed: 100).
         # @param [String] page_token
         #   Token specifying the result page to return. Optional.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -175,15 +158,14 @@ module Google
         # @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_tasklists(max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'users/@me/lists', options)
+        def list_tasklists(max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'tasks/v1/users/@me/lists', options)
           command.response_representation = Google::Apis::TasksV1::TaskLists::Representation
           command.response_class = Google::Apis::TasksV1::TaskLists
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -195,10 +177,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -211,8 +191,8 @@ module Google
         # @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 patch_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:patch, 'users/@me/lists/{tasklist}', options)
+        def patch_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'tasks/v1/users/@me/lists/{tasklist}', options)
           command.request_representation = Google::Apis::TasksV1::TaskList::Representation
           command.request_object = task_list_object
           command.response_representation = Google::Apis::TasksV1::TaskList::Representation
@@ -220,7 +200,6 @@ module Google
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -231,10 +210,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -247,8 +224,8 @@ module Google
         # @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 update_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'users/@me/lists/{tasklist}', options)
+        def update_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'tasks/v1/users/@me/lists/{tasklist}', options)
           command.request_representation = Google::Apis::TasksV1::TaskList::Representation
           command.request_object = task_list_object
           command.response_representation = Google::Apis::TasksV1::TaskList::Representation
@@ -256,7 +233,6 @@ module Google
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -268,10 +244,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -284,12 +258,11 @@ module Google
         # @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 clear_task(tasklist, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'lists/{tasklist}/clear', options)
+        def clear_task(tasklist, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/clear', options)
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -301,10 +274,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -317,13 +288,12 @@ module Google
         # @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 delete_task(tasklist, task, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'lists/{tasklist}/tasks/{task}', options)
+        def delete_task(tasklist, task, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'tasks/v1/lists/{tasklist}/tasks/{task}', options)
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.params['task'] = task unless task.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -335,10 +305,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -351,20 +319,18 @@ module Google
         # @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_task(tasklist, task, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'lists/{tasklist}/tasks/{task}', options)
+        def get_task(tasklist, task, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'tasks/v1/lists/{tasklist}/tasks/{task}', options)
           command.response_representation = Google::Apis::TasksV1::Task::Representation
           command.response_class = Google::Apis::TasksV1::Task
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.params['task'] = task unless task.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new task on the specified task list. Fails with HTTP code 403 or 429
-        # after reaching the storage limit of 100,000 tasks per account.
+        # Creates a new task on the specified task list.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [Google::Apis::TasksV1::Task] task_object
@@ -372,15 +338,13 @@ module Google
         #   Parent task identifier. If the task is created at the top level, this
         #   parameter is omitted. Optional.
         # @param [String] previous
-        #   Previous sibling task identifier. If the task is created at the first position
-        #   among its siblings, this parameter is omitted. Optional.
+        #   Previous sibling task identifier. If the task is created at the first
+        #   position among its siblings, this parameter is omitted. Optional.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -393,8 +357,8 @@ module Google
         # @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 insert_task(tasklist, task_object = nil, parent: nil, previous: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'lists/{tasklist}/tasks', options)
+        def insert_task(tasklist, task_object = nil, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/tasks', options)
           command.request_representation = Google::Apis::TasksV1::Task::Representation
           command.request_object = task_object
           command.response_representation = Google::Apis::TasksV1::Task::Representation
@@ -404,7 +368,6 @@ module Google
           command.query['previous'] = previous unless previous.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -412,11 +375,11 @@ module Google
         # @param [String] tasklist
         #   Task list identifier.
         # @param [String] completed_max
-        #   Upper bound for a task's completion date (as a RFC 3339 timestamp) to filter
-        #   by. Optional. The default is not to filter by completion date.
+        #   Upper bound for a task's completion date (as a RFC 3339 timestamp) to
+        #   filter by. Optional. The default is not to filter by completion date.
         # @param [String] completed_min
-        #   Lower bound for a task's completion date (as a RFC 3339 timestamp) to filter
-        #   by. Optional. The default is not to filter by completion date.
+        #   Lower bound for a task's completion date (as a RFC 3339 timestamp) to
+        #   filter by. Optional. The default is not to filter by completion date.
         # @param [String] due_max
         #   Upper bound for a task's due date (as a RFC 3339 timestamp) to filter by.
         #   Optional. The default is not to filter by due date.
@@ -424,29 +387,28 @@ module Google
         #   Lower bound for a task's due date (as a RFC 3339 timestamp) to filter by.
         #   Optional. The default is not to filter by due date.
         # @param [Fixnum] max_results
-        #   Maximum number of task lists returned on one page. Optional. The default is 20
-        #   (max allowed: 100).
+        #   Maximum number of task lists returned on one page. Optional. The default is
+        #   20 (max allowed: 100).
         # @param [String] page_token
         #   Token specifying the result page to return. Optional.
         # @param [Boolean] show_completed
-        #   Flag indicating whether completed tasks are returned in the result. Optional.
-        #   The default is True.
+        #   Flag indicating whether completed tasks are returned in the result.
+        #   Optional. The default is True.
         # @param [Boolean] show_deleted
         #   Flag indicating whether deleted tasks are returned in the result. Optional.
         #   The default is False.
         # @param [Boolean] show_hidden
-        #   Flag indicating whether hidden tasks are returned in the result. Optional. The
-        #   default is False.
+        #   Flag indicating whether hidden tasks are returned in the result. Optional.
+        #   The default is False.
         # @param [String] updated_min
-        #   Lower bound for a task's last modification time (as a RFC 3339 timestamp) to
-        #   filter by. Optional. The default is not to filter by last modification time.
+        #   Lower bound for a task's last modification time (as a RFC 3339 timestamp)
+        #   to filter by. Optional. The default is not to filter by last modification
+        #   time.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -459,8 +421,8 @@ module Google
         # @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_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'lists/{tasklist}/tasks', options)
+        def list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'tasks/v1/lists/{tasklist}/tasks', options)
           command.response_representation = Google::Apis::TasksV1::Tasks::Representation
           command.response_class = Google::Apis::TasksV1::Tasks
           command.params['tasklist'] = tasklist unless tasklist.nil?
@@ -476,7 +438,6 @@ module Google
           command.query['updatedMin'] = updated_min unless updated_min.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -496,10 +457,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -512,8 +471,8 @@ module Google
         # @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 move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'lists/{tasklist}/tasks/{task}/move', options)
+        def move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/tasks/{task}/move', options)
           command.response_representation = Google::Apis::TasksV1::Task::Representation
           command.response_class = Google::Apis::TasksV1::Task
           command.params['tasklist'] = tasklist unless tasklist.nil?
@@ -522,7 +481,6 @@ module Google
           command.query['previous'] = previous unless previous.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -535,10 +493,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -551,8 +507,8 @@ module Google
         # @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 patch_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:patch, 'lists/{tasklist}/tasks/{task}', options)
+        def patch_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'tasks/v1/lists/{tasklist}/tasks/{task}', options)
           command.request_representation = Google::Apis::TasksV1::Task::Representation
           command.request_object = task_object
           command.response_representation = Google::Apis::TasksV1::Task::Representation
@@ -561,7 +517,6 @@ module Google
           command.params['task'] = task unless task.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -574,10 +529,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -590,8 +543,8 @@ module Google
         # @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 update_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'lists/{tasklist}/tasks/{task}', options)
+        def update_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'tasks/v1/lists/{tasklist}/tasks/{task}', options)
           command.request_representation = Google::Apis::TasksV1::Task::Representation
           command.request_object = task_object
           command.response_representation = Google::Apis::TasksV1::Task::Representation
@@ -600,7 +553,6 @@ module Google
           command.params['task'] = task unless task.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
 
@@ -609,7 +561,6 @@ module Google
         def apply_command_defaults(command)
           command.query['key'] = key unless key.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
         end
       end
     end
diff --git a/generated/google/apis/youtube_v3.rb b/generated/google/apis/youtube_v3.rb
index 71b94e4eb..c1596fa7c 100644
--- a/generated/google/apis/youtube_v3.rb
+++ b/generated/google/apis/youtube_v3.rb
@@ -18,15 +18,15 @@ require 'google/apis/youtube_v3/representations.rb'
 
 module Google
   module Apis
-    # YouTube Data API
+    # YouTube Data API v3
     #
-    # Supports core YouTube features, such as uploading videos, creating and
-    # managing playlists, searching for content, and much more.
+    # The YouTube Data API v3 is an API that provides access to YouTube data, such
+    # as videos, playlists, and channels.
     #
-    # @see https://developers.google.com/youtube/v3
+    # @see https://developers.google.com/youtube/
     module YoutubeV3
       VERSION = 'V3'
-      REVISION = '20200423'
+      REVISION = '20200518'
 
       # Manage your YouTube account
       AUTH_YOUTUBE = 'https://www.googleapis.com/auth/youtube'
diff --git a/generated/google/apis/youtube_v3/classes.rb b/generated/google/apis/youtube_v3/classes.rb
index 30af34fa1..8cc2cf6b7 100644
--- a/generated/google/apis/youtube_v3/classes.rb
+++ b/generated/google/apis/youtube_v3/classes.rb
@@ -26,15 +26,15 @@ module Google
       class AccessPolicy
         include Google::Apis::Core::Hashable
       
-        # The value of allowed indicates whether the access to the policy is allowed or
-        # denied by default.
+        # The value of <code>allowed</code> indicates whether the access to the
+        # policy is allowed or denied by default.
         # Corresponds to the JSON property `allowed`
         # @return [Boolean]
         attr_accessor :allowed
         alias_method :allowed?, :allowed
       
-        # A list of region codes that identify countries where the default policy do not
-        # apply.
+        # A list of region codes that identify countries where the default policy do
+        # not apply.
         # Corresponds to the JSON property `exception`
         # @return [Array<String>]
         attr_accessor :exception
@@ -50,13 +50,14 @@ module Google
         end
       end
       
-      # An activity resource contains information about an action that a particular
-      # channel, or user, has taken on YouTube.The actions reported in activity feeds
-      # include rating a video, sharing a video, marking a video as a favorite,
-      # commenting on a video, uploading a video, and so forth. Each activity resource
-      # identifies the type of action, the channel associated with the action, and the
-      # resource(s) associated with the action, such as the video that was rated or
-      # uploaded.
+      # An <code><strong>activity</strong></code> resource contains
+      # information about an action that a particular channel, or user, has
+      # taken on YouTube.The actions reported in activity feeds include rating
+      # a video, sharing a video, marking a video as a favorite, commenting on
+      # a video, uploading a video, and so forth. Each <code>activity</code>
+      # resource identifies the type of action, the channel associated with
+      # the action, and the resource(s) associated with the action, such as
+      # the video that was rated or uploaded.
       class Activity
         include Google::Apis::Core::Hashable
       
@@ -66,7 +67,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::ActivityContentDetails]
         attr_accessor :content_details
       
-        # Etag of this resource.
+        # Etag of this resource
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -76,14 +77,15 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # activity".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#activity"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # Basic details about an activity, including title, description, thumbnails,
         # activity type and group.
+        # Next ID: 12
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::ActivitySnippet]
         attr_accessor :snippet
@@ -317,8 +319,8 @@ module Google
         # @return [String]
         attr_accessor :ad_tag
       
-        # The URL the client should ping to indicate that the user clicked through on
-        # this promoted item.
+        # The URL the client should ping to indicate that the user clicked through
+        # on this promoted item.
         # Corresponds to the JSON property `clickTrackingUrl`
         # @return [String]
         attr_accessor :click_tracking_url
@@ -329,14 +331,14 @@ module Google
         # @return [String]
         attr_accessor :creative_view_url
       
-        # The type of call-to-action, a message to the user indicating action that can
-        # be taken.
+        # The type of call-to-action, a message to the user indicating action that
+        # can be taken.
         # Corresponds to the JSON property `ctaType`
         # @return [String]
         attr_accessor :cta_type
       
-        # The custom call-to-action button text. If specified, it will override the
-        # default button text for the cta_type.
+        # The custom call-to-action button text. If specified, it will override
+        # the default button text for the cta_type.
         # Corresponds to the JSON property `customCtaButtonText`
         # @return [String]
         attr_accessor :custom_cta_button_text
@@ -346,15 +348,15 @@ module Google
         # @return [String]
         attr_accessor :description_text
       
-        # The URL the client should direct the user to, if the user chooses to visit the
-        # advertiser's website.
+        # The URL the client should direct the user to, if the user chooses to
+        # visit the advertiser's website.
         # Corresponds to the JSON property `destinationUrl`
         # @return [String]
         attr_accessor :destination_url
       
-        # The list of forecasting URLs. The client should ping all of these URLs when a
-        # promoted item is not available, to indicate that a promoted item could have
-        # been shown.
+        # The list of forecasting URLs. The client should ping all of these URLs
+        # when a promoted item is not available, to indicate that a promoted item
+        # could have been shown.
         # Corresponds to the JSON property `forecastingUrl`
         # @return [Array<String>]
         attr_accessor :forecasting_url
@@ -515,19 +517,19 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of activities, or events, that match the request criteria.
+        # 
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::Activity>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # activityListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#activityListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -538,8 +540,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -549,7 +551,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -574,11 +576,12 @@ module Google
       
       # Basic details about an activity, including title, description, thumbnails,
       # activity type and group.
+      # Next ID: 12
       class ActivitySnippet
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the channel associated with the
-        # activity.
+        # The ID that YouTube uses to uniquely identify the channel associated
+        # with the activity.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -589,24 +592,26 @@ module Google
         attr_accessor :channel_title
       
         # The description of the resource primarily associated with the activity.
+        # @mutable youtube.activities.insert
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The group ID associated with the activity. A group ID identifies user events
-        # that are associated with the same user and resource. For example, if a user
-        # rates a video and marks the same video as a favorite, the entries for those
-        # events would have the same group ID in the user's activity feed. In your user
-        # interface, you can avoid repetition by grouping events with the same groupId
-        # value.
+        # The group ID associated with the activity. A group ID identifies user
+        # events that are associated with the same user and resource. For example,
+        # if a user rates a video and marks the same video as a favorite, the
+        # entries for those events would have the same group ID in the user's
+        # activity feed. In your user interface, you can avoid repetition by
+        # grouping events with the same <code>groupId</code> value.
         # Corresponds to the JSON property `groupId`
         # @return [String]
         attr_accessor :group_id
       
-        # The date and time that the video was uploaded. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the video was uploaded. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # Internal representation of thumbnails for a YouTube resource.
@@ -641,8 +646,9 @@ module Google
         end
       end
       
-      # A caption resource represents a YouTube caption track. A caption track is
-      # associated with exactly one YouTube video.
+      # A <code><strong>caption</strong></code> resource represents a YouTube
+      # caption track. A caption track is associated with exactly one YouTube
+      # video.
       class Caption
         include Google::Apis::Core::Hashable
       
@@ -656,8 +662,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # caption".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#caption"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -699,13 +705,13 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::Caption>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # captionListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#captionListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -733,65 +739,74 @@ module Google
         # @return [String]
         attr_accessor :audio_track_type
       
-        # The reason that YouTube failed to process the caption track. This property is
-        # only present if the state property's value is failed.
+        # The reason that YouTube failed to process the caption track. This
+        # property is only present if the <code><a href="#state">state</a></code>
+        # property's value is <code>failed</code>.
         # Corresponds to the JSON property `failureReason`
         # @return [String]
         attr_accessor :failure_reason
       
-        # Indicates whether YouTube synchronized the caption track to the audio track in
-        # the video. The value will be true if a sync was explicitly requested when the
-        # caption track was uploaded. For example, when calling the captions.insert or
-        # captions.update methods, you can set the sync parameter to true to instruct
-        # YouTube to sync the uploaded track to the video. If the value is false,
-        # YouTube uses the time codes in the uploaded caption track to determine when to
-        # display captions.
+        # Indicates whether YouTube synchronized the caption track to the audio
+        # track in the video. The value will be <code>true</code> if a sync was
+        # explicitly requested when the caption track was uploaded. For example,
+        # when calling the <code>captions.insert</code> or
+        # <code>captions.update</code> methods, you can set the <code>sync</code>
+        # parameter to <code>true</code> to instruct YouTube to sync the uploaded
+        # track to the video. If the value is <code>false</code>, YouTube uses
+        # the time codes in the uploaded caption track to determine when to display
+        # captions.
         # Corresponds to the JSON property `isAutoSynced`
         # @return [Boolean]
         attr_accessor :is_auto_synced
         alias_method :is_auto_synced?, :is_auto_synced
       
-        # Indicates whether the track contains closed captions for the deaf and hard of
-        # hearing. The default value is false.
+        # Indicates whether the track contains closed captions for the deaf
+        # and hard of hearing. The default value is <code>false</code>.
         # Corresponds to the JSON property `isCC`
         # @return [Boolean]
         attr_accessor :is_cc
         alias_method :is_cc?, :is_cc
       
-        # Indicates whether the caption track is a draft. If the value is true, then the
-        # track is not publicly visible. The default value is false.
+        # Indicates whether the caption track is a draft. If the value is
+        # <code>true</code>, then the track is not publicly visible.
+        # The default value is <code>false</code>.
+        # @mutable youtube.captions.insert youtube.captions.update
         # Corresponds to the JSON property `isDraft`
         # @return [Boolean]
         attr_accessor :is_draft
         alias_method :is_draft?, :is_draft
       
-        # Indicates whether caption track is formatted for "easy reader," meaning it is
-        # at a third-grade level for language learners. The default value is false.
+        # Indicates whether caption track is formatted for "easy reader,"
+        # meaning it is at a third-grade level for language learners.
+        # The default value is <code>false</code>.
         # Corresponds to the JSON property `isEasyReader`
         # @return [Boolean]
         attr_accessor :is_easy_reader
         alias_method :is_easy_reader?, :is_easy_reader
       
-        # Indicates whether the caption track uses large text for the vision-impaired.
-        # The default value is false.
+        # Indicates whether the caption track uses large text for the
+        # vision-impaired. The default value is <code>false</code>.
         # Corresponds to the JSON property `isLarge`
         # @return [Boolean]
         attr_accessor :is_large
         alias_method :is_large?, :is_large
       
-        # The language of the caption track. The property value is a BCP-47 language tag.
+        # The language of the caption track. The property value is a
+        # <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt">BCP-47</a>
+        # language tag.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
         # The date and time when the caption track was last updated. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `lastUpdated`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :last_updated
       
-        # The name of the caption track. The name is intended to be visible to the user
-        # as an option during playback.
+        # The name of the caption track. The name is intended to be visible
+        # to the user as an option during playback.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -806,8 +821,9 @@ module Google
         # @return [String]
         attr_accessor :track_kind
       
-        # The ID that YouTube uses to uniquely identify the video associated with the
-        # caption track.
+        # The ID that YouTube uses to uniquely identify the video associated
+        # with the caption track.
+        # @mutable youtube.captions.insert
         # Corresponds to the JSON property `videoId`
         # @return [String]
         attr_accessor :video_id
@@ -838,7 +854,7 @@ module Google
       class CdnSettings
         include Google::Apis::Core::Hashable
       
-        # The format of the video stream that you are sending to Youtube.
+        # The format of the video stream that you are sending to Youtube. <br><br>
         # Corresponds to the JSON property `format`
         # @return [String]
         attr_accessor :format
@@ -877,12 +893,13 @@ module Google
         end
       end
       
-      # A channel resource contains information about a YouTube channel.
+      # A <code><strong>channel</strong></code> resource contains
+      # information about a YouTube channel.
       class Channel
         include Google::Apis::Core::Hashable
       
-        # The auditDetails object encapsulates channel data that is relevant for YouTube
-        # Partners during the audit process.
+        # The <code>auditDetails</code> object encapsulates channel data that is
+        # relevant for YouTube Partners during the audit process.
         # Corresponds to the JSON property `auditDetails`
         # @return [Google::Apis::YoutubeV3::ChannelAuditDetails]
         attr_accessor :audit_details
@@ -897,14 +914,14 @@ module Google
         # @return [Google::Apis::YoutubeV3::ChannelContentDetails]
         attr_accessor :content_details
       
-        # The contentOwnerDetails object encapsulates channel data that is relevant for
-        # YouTube Partners linked with the channel.
+        # The <code>contentOwnerDetails</code> object encapsulates channel data that
+        # is relevant for YouTube Partners linked with the channel.
         # Corresponds to the JSON property `contentOwnerDetails`
         # @return [Google::Apis::YoutubeV3::ChannelContentOwnerDetails]
         attr_accessor :content_owner_details
       
-        # The conversionPings object encapsulates information about conversion pings
-        # that need to be respected by the channel.
+        # The <code>conversionPings</code> object encapsulates information about
+        # conversion pings that need to be respected by the channel.
         # Corresponds to the JSON property `conversionPings`
         # @return [Google::Apis::YoutubeV3::ChannelConversionPings]
         attr_accessor :conversion_pings
@@ -919,14 +936,14 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Describes an invideo promotion campaign consisting of multiple promoted items.
-        # A campaign belongs to a single channel_id.
+        # Describes an invideo promotion campaign consisting of multiple promoted
+        # items. A campaign belongs to a single channel_id.
         # Corresponds to the JSON property `invideoPromotion`
         # @return [Google::Apis::YoutubeV3::InvideoPromotion]
         attr_accessor :invideo_promotion
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # channel".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#channel"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -980,8 +997,8 @@ module Google
         end
       end
       
-      # The auditDetails object encapsulates channel data that is relevant for YouTube
-      # Partners during the audit process.
+      # The <code>auditDetails</code> object encapsulates channel data that is
+      # relevant for YouTube Partners during the audit process.
       class ChannelAuditDetails
         include Google::Apis::Core::Hashable
       
@@ -1019,13 +1036,13 @@ module Google
       class ChannelBannerResource
         include Google::Apis::Core::Hashable
       
-        # Etag of this resource.
+        # 
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # channelBannerResource".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#channelBannerResource"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1106,37 +1123,51 @@ module Google
         class RelatedPlaylists
           include Google::Apis::Core::Hashable
         
-          # The ID of the playlist that contains the channel"s favorite videos. Use the
-          # playlistItems.insert and  playlistItems.delete to add or remove items from
-          # that list.
+          # The ID of the playlist that contains the channel"s favorite videos. Use
+          # the <code> <a
+          # href="/youtube/v3/docs/playlistItems/insert">playlistItems.insert</a></code>
+          # and <code> <a
+          # href="/youtube/v3/docs/playlistItems/delete">playlistItems.delete</a></code>
+          # to add or remove items from that list.
           # Corresponds to the JSON property `favorites`
           # @return [String]
           attr_accessor :favorites
         
           # The ID of the playlist that contains the channel"s liked videos. Use the
-          # playlistItems.insert and  playlistItems.delete to add or remove items from
-          # that list.
+          # <code> <a href="/youtube/v3/docs/playlistItems/insert">
+          # playlistItems.insert</a></code> and <code> <a
+          # href="/youtube/v3/docs/playlistItems/delete">playlistItems.delete</a></code>
+          # to add or remove items from that list.
           # Corresponds to the JSON property `likes`
           # @return [String]
           attr_accessor :likes
         
-          # The ID of the playlist that contains the channel"s uploaded videos. Use the
-          # videos.insert method to upload new videos and the videos.delete method to
+          # The ID of the playlist that contains the channel"s uploaded videos. Use
+          # the <code> <a
+          # href="/youtube/v3/docs/videos/insert">videos.insert</a></code> method to
+          # upload new videos and the <code><a
+          # href="/youtube/v3/docs/videos/delete">videos.delete</a></code> method to
           # delete previously uploaded videos.
           # Corresponds to the JSON property `uploads`
           # @return [String]
           attr_accessor :uploads
         
           # The ID of the playlist that contains the channel"s watch history. Use the
-          # playlistItems.insert and  playlistItems.delete to add or remove items from
-          # that list.
+          # <code> <a
+          # href="/youtube/v3/docs/playlistItems/insert">playlistItems.insert</a></code>
+          # and <code> <a
+          # href="/youtube/v3/docs/playlistItems/delete">playlistItems.delete</a></code>
+          # to add or remove items from that list.
           # Corresponds to the JSON property `watchHistory`
           # @return [String]
           attr_accessor :watch_history
         
-          # The ID of the playlist that contains the channel"s watch later playlist. Use
-          # the playlistItems.insert and  playlistItems.delete to add or remove items from
-          # that list.
+          # The ID of the playlist that contains the channel"s watch later playlist.
+          # Use the <code><a
+          # href="/youtube/v3/docs/playlistItems/insert">playlistItems.insert</a></code>
+          # and <code> <a
+          # href="/youtube/v3/docs/playlistItems/delete">playlistItems.delete</a></code>
+          # to add or remove items from that list.
           # Corresponds to the JSON property `watchLater`
           # @return [String]
           attr_accessor :watch_later
@@ -1156,8 +1187,8 @@ module Google
         end
       end
       
-      # The contentOwnerDetails object encapsulates channel data that is relevant for
-      # YouTube Partners linked with the channel.
+      # The <code>contentOwnerDetails</code> object encapsulates channel data that
+      # is relevant for YouTube Partners linked with the channel.
       class ChannelContentOwnerDetails
         include Google::Apis::Core::Hashable
       
@@ -1166,10 +1197,12 @@ module Google
         # @return [String]
         attr_accessor :content_owner
       
-        # The date and time of when the channel was linked to the content owner. The
-        # value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time of when the channel was linked to the content owner.
+        # The value is specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO
+        # 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `timeLinked`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :time_linked
       
         def initialize(**args)
@@ -1194,12 +1227,13 @@ module Google
         # @return [String]
         attr_accessor :context
       
-        # The url (without the schema) that the player shall send the ping to. It's at
-        # caller's descretion to decide which schema to use (http vs https) Example of a
-        # returned url: //googleads.g.doubleclick.net/pagead/ viewthroughconversion/
-        # 962985656/?data=path%3DtHe_path%3Btype%3D cview%3Butuid%
-        # 3DGISQtTNGYqaYl4sKxoVvKA&labe=default The caller must append biscotti
-        # authentication (ms param in case of mobile, for example) to this ping.
+        # The url (without the schema) that the player shall send the ping to.
+        # It's at caller's descretion to decide which schema to use (http vs https)
+        # Example of a returned url: //googleads.g.doubleclick.net/pagead/
+        # viewthroughconversion/962985656/?data=path%3DtHe_path%3Btype%3D
+        # cview%3Butuid%3DGISQtTNGYqaYl4sKxoVvKA&labe=default
+        # The caller must append biscotti authentication (ms param in case of
+        # mobile, for example) to this ping.
         # Corresponds to the JSON property `conversionUrl`
         # @return [String]
         attr_accessor :conversion_url
@@ -1215,14 +1249,14 @@ module Google
         end
       end
       
-      # The conversionPings object encapsulates information about conversion pings
-      # that need to be respected by the channel.
+      # The <code>conversionPings</code> object encapsulates information about
+      # conversion pings that need to be respected by the channel.
       class ChannelConversionPings
         include Google::Apis::Core::Hashable
       
         # Pings that the app shall fire (authenticated by biscotti cookie). Each ping
-        # has a context, in which the app must fire the ping, and a url identifying the
-        # ping.
+        # has a context, in which the app must fire the ping, and a url identifying
+        # the ping.
         # Corresponds to the JSON property `pings`
         # @return [Array<Google::Apis::YoutubeV3::ChannelConversionPing>]
         attr_accessor :pings
@@ -1251,19 +1285,19 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of channels that match the request criteria.
+        # 
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::Channel>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # channelListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#channelListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1274,8 +1308,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -1285,7 +1319,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -1389,8 +1423,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # channelSection".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#channelSection"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1471,13 +1505,13 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::ChannelSection>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # channelSectionListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#channelSectionListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -1519,8 +1553,8 @@ module Google
       class ChannelSectionSnippet
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the channel that published the
-        # channel section.
+        # The ID that YouTube uses to uniquely identify the channel that published
+        # the channel section.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -1641,8 +1675,8 @@ module Google
         # @return [String]
         attr_accessor :keywords
       
-        # Whether user-submitted comments left on the channel page need to be approved
-        # by the channel owner to be publicly visible.
+        # Whether user-submitted comments left on the channel page need to be
+        # approved by the channel owner to be publicly visible.
         # Corresponds to the JSON property `moderateComments`
         # @return [Boolean]
         attr_accessor :moderate_comments
@@ -1733,10 +1767,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::ChannelLocalization]
         attr_accessor :localized
       
-        # The date and time that the channel was created. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the channel was created. The value is specified in
+        # < a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # Internal representation of thumbnails for a YouTube resource.
@@ -1815,14 +1850,15 @@ module Google
       class ChannelStatus
         include Google::Apis::Core::Hashable
       
-        # If true, then the user is linked to either a YouTube username or G+ account.
-        # Otherwise, the user doesn't have a public YouTube identity.
+        # If true, then the user is linked to either a YouTube username or G+
+        # account. Otherwise, the user doesn't have a public YouTube identity.
         # Corresponds to the JSON property `isLinked`
         # @return [Boolean]
         attr_accessor :is_linked
         alias_method :is_linked?, :is_linked
       
         # The long uploads status of this channel. See
+        # https://support.google.com/youtube/answer/71673 for more information.
         # Corresponds to the JSON property `longUploadsStatus`
         # @return [String]
         attr_accessor :long_uploads_status
@@ -1868,7 +1904,8 @@ module Google
         attr_accessor :topic_categories
       
         # A list of Freebase topic IDs associated with the channel. You can retrieve
-        # information about each topic using the Freebase Topic API.
+        # information about each topic using the <a
+        # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>.
         # Corresponds to the JSON property `topicIds`
         # @return [Array<String>]
         attr_accessor :topic_ids
@@ -1884,7 +1921,7 @@ module Google
         end
       end
       
-      # A comment represents a single YouTube comment.
+      # A <code><strong>comment</strong></code> represents a single YouTube comment.
       class Comment
         include Google::Apis::Core::Hashable
       
@@ -1898,8 +1935,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # comment".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#comment"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1941,14 +1978,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::Comment>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # commentListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#commentListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1964,7 +2001,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -1992,7 +2029,7 @@ module Google
       
         # The id of the author's YouTube channel, if any.
         # Corresponds to the JSON property `authorChannelId`
-        # @return [Object]
+        # @return [Google::Apis::YoutubeV3::CommentSnippetAuthorChannelId]
         attr_accessor :author_channel_id
       
         # Link to the author's YouTube channel, if any.
@@ -2016,9 +2053,9 @@ module Google
         attr_accessor :can_rate
         alias_method :can_rate?, :can_rate
       
-        # The id of the corresponding YouTube channel. In case of a channel comment this
-        # is the channel the comment refers to. In case of a video comment it's the
-        # video's channel.
+        # The id of the corresponding YouTube channel. In case of a channel comment
+        # this is the channel the comment refers to. In case of a video comment
+        # it's the video's channel.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -2040,30 +2077,32 @@ module Google
         attr_accessor :parent_id
       
         # The date and time when the comment was orignally published. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
-        # The comment's text. The format is either plain text or HTML dependent on what
-        # has been requested. Even the plain text representation may differ from the
-        # text originally posted in that it may replace video links with video titles
-        # etc.
+        # The comment's text. The format is either plain text or HTML dependent on
+        # what has been requested. Even the plain text representation may differ
+        # from the text originally posted in that it may replace video links with
+        # video titles etc.
         # Corresponds to the JSON property `textDisplay`
         # @return [String]
         attr_accessor :text_display
       
         # The comment's original raw text as initially posted or last updated. The
-        # original text will only be returned if it is accessible to the viewer, which
-        # is only guaranteed if the viewer is the comment's author.
+        # original text will only be returned if it is accessible to the viewer,
+        # which is only guaranteed if the viewer is the comment's author.
         # Corresponds to the JSON property `textOriginal`
         # @return [String]
         attr_accessor :text_original
       
-        # The date and time when was last updated . The value is specified in ISO 8601 (
-        # YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time when was last updated . The value is
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `updatedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :updated_at
       
         # The ID of the video the comment refers to, if any.
@@ -2071,9 +2110,9 @@ module Google
         # @return [String]
         attr_accessor :video_id
       
-        # The rating the viewer has given to this comment. For the time being this will
-        # never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE. This may
-        # change in the future.
+        # The rating the viewer has given to this comment. For the time being this
+        # will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
+        # This may change in the future.
         # Corresponds to the JSON property `viewerRating`
         # @return [String]
         attr_accessor :viewer_rating
@@ -2102,9 +2141,28 @@ module Google
         end
       end
       
-      # A comment thread represents information that applies to a top level comment
-      # and all its replies. It can also include the top level comment itself and some
-      # of the replies.
+      # The id of the author's YouTube channel, if any.
+      class CommentSnippetAuthorChannelId
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # A <code><strong>comment thread</strong></code> represents information that
+      # applies to a top level comment and all its replies. It can also include the
+      # top level comment itself and some of the replies.
       class CommentThread
         include Google::Apis::Core::Hashable
       
@@ -2118,8 +2176,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # commentThread".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#commentThread"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2167,14 +2225,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::CommentThread>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # commentThreadListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#commentThreadListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2190,7 +2248,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -2217,8 +2275,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A limited number of replies. Unless the number of replies returned equals
-        # total_reply_count in the snippet the returned replies are only a subset of the
-        # total number of replies.
+        # total_reply_count in the snippet the returned replies are only a subset
+        # of the total number of replies.
         # Corresponds to the JSON property `comments`
         # @return [Array<Google::Apis::YoutubeV3::Comment>]
         attr_accessor :comments
@@ -2244,21 +2302,21 @@ module Google
         attr_accessor :can_reply
         alias_method :can_reply?, :can_reply
       
-        # The YouTube channel the comments in the thread refer to or the channel with
-        # the video the comments refer to. If video_id isn't set the comments refer to
-        # the channel itself.
+        # The YouTube channel the comments in the thread refer to or the channel
+        # with the video the comments refer to. If video_id isn't set the comments
+        # refer to the channel itself.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
       
-        # Whether the thread (and therefore all its comments) is visible to all YouTube
-        # users.
+        # Whether the thread (and therefore all its comments) is visible to all
+        # YouTube users.
         # Corresponds to the JSON property `isPublic`
         # @return [Boolean]
         attr_accessor :is_public
         alias_method :is_public?, :is_public
       
-        # A comment represents a single YouTube comment.
+        # A <code><strong>comment</strong></code> represents a single YouTube comment.
         # Corresponds to the JSON property `topLevelComment`
         # @return [Google::Apis::YoutubeV3::Comment]
         attr_accessor :top_level_comment
@@ -2289,26 +2347,27 @@ module Google
         end
       end
       
-      # Ratings schemes. The country-specific ratings are mostly for movies and shows.
-      # NEXT_ID: 72
+      # Ratings schemes. The country-specific ratings are mostly for
+      # movies and shows.
+      # LINT.IfChange
       class ContentRating
         include Google::Apis::Core::Hashable
       
-        # The video's Australian Classification Board (ACB) or Australian Communications
-        # and Media Authority (ACMA) rating. ACMA ratings are used to classify children'
-        # s television programming.
+        # The video's Australian Classification Board (ACB) or Australian
+        # Communications and Media Authority (ACMA) rating. ACMA ratings are used
+        # to classify children's television programming.
         # Corresponds to the JSON property `acbRating`
         # @return [String]
         attr_accessor :acb_rating
       
-        # The video's rating from Italy's Autorità per le Garanzie nelle Comunicazioni (
-        # AGCOM).
+        # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle
+        # Comunicazioni (AGCOM).
         # Corresponds to the JSON property `agcomRating`
         # @return [String]
         attr_accessor :agcom_rating
       
-        # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean
-        # television.
+        # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n)
+        # rating for Chilean television.
         # Corresponds to the JSON property `anatelRating`
         # @return [String]
         attr_accessor :anatel_rating
@@ -2323,23 +2382,27 @@ module Google
         # @return [String]
         attr_accessor :bfvc_rating
       
-        # The video's rating from the Austrian Board of Media Classification (
-        # Bundesministerium für Unterricht, Kunst und Kultur).
+        # The video's rating from the Austrian Board of Media Classification
+        # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur).
         # Corresponds to the JSON property `bmukkRating`
         # @return [String]
         attr_accessor :bmukk_rating
       
-        # Rating system for Canadian TV - Canadian TV Classification System The video's
-        # rating from the Canadian Radio-Television and Telecommunications Commission (
-        # CRTC) for Canadian English-language broadcasts. For more information, see the
-        # Canadian Broadcast Standards Council website.
+        # Rating system for Canadian TV - Canadian TV Classification System
+        # The video's rating from the Canadian Radio-Television and
+        # Telecommunications Commission (CRTC) for Canadian English-language
+        # broadcasts. For more information, see the
+        # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian
+        # Broadcast Standards Council</a> website.
         # Corresponds to the JSON property `catvRating`
         # @return [String]
         attr_accessor :catv_rating
       
-        # The video's rating from the Canadian Radio-Television and Telecommunications
-        # Commission (CRTC) for Canadian French-language broadcasts. For more
-        # information, see the Canadian Broadcast Standards Council website.
+        # The video's rating from the Canadian Radio-Television and
+        # Telecommunications Commission (CRTC) for Canadian French-language
+        # broadcasts. For more information, see the
+        # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian
+        # Broadcast Standards Council</a> website.
         # Corresponds to the JSON property `catvfrRating`
         # @return [String]
         attr_accessor :catvfr_rating
@@ -2349,12 +2412,14 @@ module Google
         # @return [String]
         attr_accessor :cbfc_rating
       
-        # The video's Consejo de Calificación Cinematográfica (Chile) rating.
+        # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile)
+        # rating.
         # Corresponds to the JSON property `cccRating`
         # @return [String]
         attr_accessor :ccc_rating
       
-        # The video's rating from Portugal's Comissão de Classificação de Espect´culos.
+        # The video's rating from Portugal's Comiss&atilde;o de
+        # Classifica&ccedil;&atilde;o de Espect&acute;culos.
         # Corresponds to the JSON property `cceRating`
         # @return [String]
         attr_accessor :cce_rating
@@ -2369,12 +2434,14 @@ module Google
         # @return [String]
         attr_accessor :chvrs_rating
       
-        # The video's rating from the Commission de Contrôle des Films (Belgium).
+        # The video's rating from the Commission de Contr&ocirc;le des Films
+        # (Belgium).
         # Corresponds to the JSON property `cicfRating`
         # @return [String]
         attr_accessor :cicf_rating
       
-        # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).
+        # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI
+        # (CNA).
         # Corresponds to the JSON property `cnaRating`
         # @return [String]
         attr_accessor :cna_rating
@@ -2384,14 +2451,14 @@ module Google
         # @return [String]
         attr_accessor :cnc_rating
       
-        # The video's rating from France's Conseil supérieur de l?audiovisuel, which
-        # rates broadcast content.
+        # The video's rating from France's Conseil sup&eacute;rieur de
+        # l’audiovisuel, which rates broadcast content.
         # Corresponds to the JSON property `csaRating`
         # @return [String]
         attr_accessor :csa_rating
       
-        # The video's rating from Luxembourg's Commission de surveillance de la
-        # classification des films (CSCF).
+        # The video's rating from Luxembourg's Commission de surveillance
+        # de la classification des films (CSCF).
         # Corresponds to the JSON property `cscfRating`
         # @return [String]
         attr_accessor :cscf_rating
@@ -2401,8 +2468,8 @@ module Google
         # @return [String]
         attr_accessor :czfilm_rating
       
-        # The video's Departamento de Justiça, Classificação, Qualificação e Títulos (
-        # DJCQT - Brazil) rating.
+        # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o,
+        # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating.
         # Corresponds to the JSON property `djctqRating`
         # @return [String]
         attr_accessor :djctq_rating
@@ -2412,8 +2479,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :djctq_rating_reasons
       
-        # Rating system in Turkey - Evaluation and Classification Board of the Ministry
-        # of Culture and Tourism
+        # Rating system in Turkey - Evaluation and Classification Board of the
+        # Ministry of Culture and Tourism
         # Corresponds to the JSON property `ecbmctRating`
         # @return [String]
         attr_accessor :ecbmct_rating
@@ -2428,7 +2495,8 @@ module Google
         # @return [String]
         attr_accessor :egfilm_rating
       
-        # The video's Eirin (映倫) rating. Eirin is the Japanese rating system.
+        # The video's Eirin (&#26144;&#20523;) rating.
+        # Eirin is the Japanese rating system.
         # Corresponds to the JSON property `eirinRating`
         # @return [String]
         attr_accessor :eirin_rating
@@ -2438,14 +2506,17 @@ module Google
         # @return [String]
         attr_accessor :fcbm_rating
       
-        # The video's rating from Hong Kong's Office for Film, Newspaper and Article
-        # Administration.
+        # The video's rating from Hong Kong's Office for Film, Newspaper
+        # and Article Administration.
         # Corresponds to the JSON property `fcoRating`
         # @return [String]
         attr_accessor :fco_rating
       
-        # This property has been deprecated. Use the contentDetails.contentRating.
-        # cncRating instead.
+        # <span class="deprecated">This property has been deprecated. Use the
+        # <code><a
+        # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.
+        # cncRating</a></code>
+        # instead.</span>
         # Corresponds to the JSON property `fmocRating`
         # @return [String]
         attr_accessor :fmoc_rating
@@ -2460,8 +2531,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :fpb_rating_reasons
       
-        # The video's Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germany)
-        # rating.
+        # The video's Freiwillige Selbstkontrolle der Filmwirtschaft
+        # (FSK - Germany) rating.
         # Corresponds to the JSON property `fskRating`
         # @return [String]
         attr_accessor :fsk_rating
@@ -2471,14 +2542,16 @@ module Google
         # @return [String]
         attr_accessor :grfilm_rating
       
-        # The video's Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA -
-        # Spain) rating.
+        # The video's Instituto de la Cinematograf&iacute;a y de las Artes
+        # Audiovisuales (ICAA - Spain) rating.
         # Corresponds to the JSON property `icaaRating`
         # @return [String]
         attr_accessor :icaa_rating
       
-        # The video's Irish Film Classification Office (IFCO - Ireland) rating. See the
-        # IFCO website for more information.
+        # The video's Irish Film Classification Office (IFCO - Ireland) rating.
+        # See the <a
+        # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a>
+        # website for more information.
         # Corresponds to the JSON property `ifcoRating`
         # @return [String]
         attr_accessor :ifco_rating
@@ -2499,13 +2572,15 @@ module Google
         # @return [String]
         attr_accessor :kfcb_rating
       
+        # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut
         # voor de Classificatie van Audiovisuele Media (Netherlands).
         # Corresponds to the JSON property `kijkwijzerRating`
         # @return [String]
         attr_accessor :kijkwijzer_rating
       
-        # The video's Korea Media Rating Board (영상물등급위원회) rating. The KMRB rates videos
-        # in South Korea.
+        # The video's Korea Media Rating Board
+        # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating.
+        # The KMRB rates videos in South Korea.
         # Corresponds to the JSON property `kmrbRating`
         # @return [String]
         attr_accessor :kmrb_rating
@@ -2520,8 +2595,8 @@ module Google
         # @return [String]
         attr_accessor :mccaa_rating
       
-        # The video's rating from the Danish Film Institute's (Det Danske Filminstitut)
-        # Media Council for Children and Young People.
+        # The video's rating from the Danish Film Institute's (Det Danske
+        # Filminstitut) Media Council for Children and Young People.
         # Corresponds to the JSON property `mccypRating`
         # @return [String]
         attr_accessor :mccyp_rating
@@ -2542,19 +2617,21 @@ module Google
         # @return [String]
         attr_accessor :medietilsynet_rating
       
-        # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti (
-        # National Audiovisual Institute).
+        # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti
+        # (National Audiovisual Institute).
         # Corresponds to the JSON property `mekuRating`
         # @return [String]
         attr_accessor :meku_rating
       
         # The rating system for MENA countries, a clone of MPAA. It is needed to
+        # prevent titles go live w/o additional QC check, since some of them can be
+        # inappropriate for the countries at all. See b/33408548 for more details.
         # Corresponds to the JSON property `menaMpaaRating`
         # @return [String]
         attr_accessor :mena_mpaa_rating
       
-        # The video's rating from the Ministero dei Beni e delle Attività Culturali e
-        # del Turismo (Italy).
+        # The video's rating from the Ministero dei Beni e delle Attivit&agrave;
+        # Culturali e del Turismo (Italy).
         # Corresponds to the JSON property `mibacRating`
         # @return [String]
         attr_accessor :mibac_rating
@@ -2564,7 +2641,8 @@ module Google
         # @return [String]
         attr_accessor :moc_rating
       
-        # The video's rating from Taiwan's Ministry of Culture (文化部).
+        # The video's rating from Taiwan's Ministry of Culture
+        # (&#25991;&#21270;&#37096;).
         # Corresponds to the JSON property `moctwRating`
         # @return [String]
         attr_accessor :moctw_rating
@@ -2574,14 +2652,14 @@ module Google
         # @return [String]
         attr_accessor :mpaa_rating
       
-        # The rating system for trailer, DVD, and Ad in the US. See http://movielabs.com/
-        # md/ratings/v2.3/html/US_MPAAT_Ratings.html.
+        # The rating system for trailer, DVD, and Ad in the US.  See
+        # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html.
         # Corresponds to the JSON property `mpaatRating`
         # @return [String]
         attr_accessor :mpaat_rating
       
-        # The video's rating from the Movie and Television Review and Classification
-        # Board (Philippines).
+        # The video's rating from the Movie and Television Review and
+        # Classification Board (Philippines).
         # Corresponds to the JSON property `mtrcbRating`
         # @return [String]
         attr_accessor :mtrcb_rating
@@ -2596,7 +2674,8 @@ module Google
         # @return [String]
         attr_accessor :nbcpl_rating
       
-        # The video's rating from the Bulgarian National Film Center.
+        # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian
+        # National Film Center</a>.
         # Corresponds to the JSON property `nfrcRating`
         # @return [String]
         attr_accessor :nfrc_rating
@@ -2606,19 +2685,19 @@ module Google
         # @return [String]
         attr_accessor :nfvcb_rating
       
-        # The video's rating from the Nacionãlais Kino centrs (National Film Centre of
-        # Latvia).
+        # The video's rating from the Nacion&atilde;lais Kino centrs (National Film
+        # Centre of Latvia).
         # Corresponds to the JSON property `nkclvRating`
         # @return [String]
         attr_accessor :nkclv_rating
       
-        # 
+        # The National Media Council ratings system for United Arab Emirates.
         # Corresponds to the JSON property `nmcRating`
         # @return [String]
         attr_accessor :nmc_rating
       
-        # The video's Office of Film and Literature Classification (OFLC - New Zealand)
-        # rating.
+        # The video's Office of Film and Literature Classification
+        # (OFLC - New Zealand) rating.
         # Corresponds to the JSON property `oflcRating`
         # @return [String]
         attr_accessor :oflc_rating
@@ -2628,8 +2707,8 @@ module Google
         # @return [String]
         attr_accessor :pefilm_rating
       
-        # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating Committee
-        # of the National Office of Film.
+        # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating
+        # Committee of the National Office of Film.
         # Corresponds to the JSON property `rcnofRating`
         # @return [String]
         attr_accessor :rcnof_rating
@@ -2639,19 +2718,20 @@ module Google
         # @return [String]
         attr_accessor :resorteviolencia_rating
       
-        # The video's General Directorate of Radio, Television and Cinematography (
-        # Mexico) rating.
+        # The video's General Directorate of Radio, Television and Cinematography
+        # (Mexico) rating.
         # Corresponds to the JSON property `rtcRating`
         # @return [String]
         attr_accessor :rtc_rating
       
-        # The video's rating from Ireland's Raidió Teilifís Éireann.
+        # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s
+        # &Eacute;ireann.
         # Corresponds to the JSON property `rteRating`
         # @return [String]
         attr_accessor :rte_rating
       
-        # The video's National Film Registry of the Russian Federation (MKRF - Russia)
-        # rating.
+        # The video's National Film Registry of the Russian Federation
+        # (MKRF - Russia) rating.
         # Corresponds to the JSON property `russiaRating`
         # @return [String]
         attr_accessor :russia_rating
@@ -2666,7 +2746,8 @@ module Google
         # @return [String]
         attr_accessor :smais_rating
       
-        # The video's rating from Statens medieråd (Sweden's National Media Council).
+        # The video's rating from Statens medier&aring;d (Sweden's National Media
+        # Council).
         # Corresponds to the JSON property `smsaRating`
         # @return [String]
         attr_accessor :smsa_rating
@@ -2792,11 +2873,13 @@ module Google
         end
       end
       
-      # A guideCategory resource identifies a category that YouTube algorithmically
-      # assigns based on a channel's content or other indicators, such as the channel'
-      # s popularity. The list is similar to video categories, with the difference
-      # being that a video's uploader can assign a video category but only YouTube can
-      # assign a channel category.
+      # A <code><strong>guideCategory</strong></code> resource identifies a category
+      # that YouTube algorithmically assigns based on a
+      # channel's content or other indicators, such as the channel's popularity. The
+      # list is similar to <a
+      # href=\"/youtube/v3/docs/videocategory.html\">video categories</a>, with the
+      # difference being that a video's uploader can assign a video category but only
+      # YouTube can assign a channel category.
       class GuideCategory
         include Google::Apis::Core::Hashable
       
@@ -2810,8 +2893,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # guideCategory".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#guideCategory"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2848,21 +2931,21 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of categories that can be associated with YouTube channels. In this map,
-        # the category ID is the map key, and its value is the corresponding
-        # guideCategory resource.
+        # A list of categories that can be associated with YouTube channels. In this
+        # map, the category ID is the map key, and its value is the corresponding
+        # <code>guideCategory</code> resource.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::GuideCategory>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # guideCategoryListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#guideCategoryListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2873,8 +2956,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -2884,7 +2967,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -2932,8 +3015,8 @@ module Google
         end
       end
       
-      # An i18nLanguage resource identifies a UI language currently supported by
-      # YouTube.
+      # An <code><strong>i18nLanguage</strong></code> resource identifies a UI
+      # language currently supported by YouTube.
       class I18nLanguage
         include Google::Apis::Core::Hashable
       
@@ -2947,14 +3030,14 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # i18nLanguage".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#i18nLanguage"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Basic details about an i18n language, such as language code and human-readable
-        # name.
+        # Basic details about an i18n language, such as language code and
+        # human-readable name.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::I18nLanguageSnippet]
         attr_accessor :snippet
@@ -2986,19 +3069,20 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of supported i18n languages. In this map, the i18n language ID is the
-        # map key, and its value is the corresponding i18nLanguage resource.
+        # A list of supported i18n languages. In this map, the i18n language ID is
+        # the map key, and its value is the corresponding <code>i18nLanguage</code>
+        # resource.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::I18nLanguage>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # i18nLanguageListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#i18nLanguageListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -3017,8 +3101,8 @@ module Google
         end
       end
       
-      # Basic details about an i18n language, such as language code and human-readable
-      # name.
+      # Basic details about an i18n language, such as language code and
+      # human-readable name.
       class I18nLanguageSnippet
         include Google::Apis::Core::Hashable
       
@@ -3043,7 +3127,8 @@ module Google
         end
       end
       
-      # A i18nRegion resource identifies a region where YouTube is available.
+      # A <code><strong>i18nRegion</strong></code> resource identifies a region where
+      # YouTube is available.
       class I18nRegion
         include Google::Apis::Core::Hashable
       
@@ -3057,8 +3142,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # i18nRegion".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#i18nRegion"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3096,19 +3181,20 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of regions where YouTube is available. In this map, the i18n region ID
-        # is the map key, and its value is the corresponding i18nRegion resource.
+        # A list of regions where YouTube is available. In this map, the i18n region
+        # ID is the map key, and its value is the corresponding
+        # <code>i18nRegion</code> resource.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::I18nRegion>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # i18nRegionListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#i18nRegionListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -3163,8 +3249,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::LocalizedProperty]
         attr_accessor :background_image_url
       
-        # This is used only in update requests; if it's set, we use this URL to generate
-        # all of the above banner URLs.
+        # This is used only in update requests; if it's set, we use this URL to
+        # generate all of the above banner URLs.
         # Corresponds to the JSON property `bannerExternalUrl`
         # @return [String]
         attr_accessor :banner_external_url
@@ -3244,8 +3330,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::LocalizedProperty]
         attr_accessor :large_branded_banner_image_imap_script
       
-        # The URL for the 854px by 70px image that appears below the video player in the
-        # expanded video view of the video watch page.
+        # The URL for the 854px by 70px image that appears below the video player in
+        # the expanded video view of the video watch page.
         # Corresponds to the JSON property `largeBrandedBannerImageUrl`
         # @return [Google::Apis::YoutubeV3::LocalizedProperty]
         attr_accessor :large_branded_banner_image_url
@@ -3255,21 +3341,22 @@ module Google
         # @return [Google::Apis::YoutubeV3::LocalizedProperty]
         attr_accessor :small_branded_banner_image_imap_script
       
-        # The URL for the 640px by 70px banner image that appears below the video player
-        # in the default view of the video watch page.
+        # The URL for the 640px by 70px banner image that appears below the video
+        # player in the default view of the video watch page.
+        # The URL for the image that appears above the top-left corner of the video
+        # player. This is a 25-pixel-high image with a flexible width that cannot
+        # exceed 170 pixels.
         # Corresponds to the JSON property `smallBrandedBannerImageUrl`
         # @return [Google::Apis::YoutubeV3::LocalizedProperty]
         attr_accessor :small_branded_banner_image_url
       
-        # The URL for a 1px by 1px tracking pixel that can be used to collect statistics
-        # for views of the channel or video pages.
+        # The URL for a 1px by 1px tracking pixel that can be used to collect
+        # statistics for views of the channel or video pages.
         # Corresponds to the JSON property `trackingImageUrl`
         # @return [String]
         attr_accessor :tracking_image_url
       
-        # The URL for the image that appears above the top-left corner of the video
-        # player. This is a 25-pixel-high image with a flexible width that cannot exceed
-        # 170 pixels.
+        # 
         # Corresponds to the JSON property `watchIconImageUrl`
         # @return [String]
         attr_accessor :watch_icon_image_url
@@ -3309,23 +3396,37 @@ module Google
       class IngestionInfo
         include Google::Apis::Core::Hashable
       
-        # The backup ingestion URL that you should use to stream video to YouTube. You
-        # have the option of simultaneously streaming the content that you are sending
-        # to the ingestionAddress to this URL.
+        # The backup ingestion URL that you should use to stream video to
+        # YouTube. You have the option of simultaneously streaming the content
+        # that you are sending to the <code>ingestionAddress</code> to this URL.
         # Corresponds to the JSON property `backupIngestionAddress`
         # @return [String]
         attr_accessor :backup_ingestion_address
       
-        # The primary ingestion URL that you should use to stream video to YouTube. You
-        # must stream video to this URL.
-        # Depending on which application or tool you use to encode your video stream,
-        # you may need to enter the stream URL and stream name separately or you may
-        # need to concatenate them in the following format:
-        # STREAM_URL/STREAM_NAME
+        # The primary ingestion URL that you should use to stream video to
+        # YouTube. You must stream video to this URL.<br><br>
+        # Depending on which application or tool you use to encode
+        # your video stream, you may need to enter the stream URL and stream
+        # name separately or you may need to concatenate them in the following
+        # format:<br><pre><strong>STREAM_URL/STREAM_NAME</strong></pre>
         # Corresponds to the JSON property `ingestionAddress`
         # @return [String]
         attr_accessor :ingestion_address
       
+        # This ingestion url may be used instead of
+        # <code>backupIngestionAddress</code> in order to stream via RTMPS. Not
+        # applicable to non-RTMP streams.
+        # Corresponds to the JSON property `rtmpsBackupIngestionAddress`
+        # @return [String]
+        attr_accessor :rtmps_backup_ingestion_address
+      
+        # This ingestion url may be used instead of
+        # <code>ingestionAddress</code> in order to stream via RTMPS. Not applicable
+        # to non-RTMP streams.
+        # Corresponds to the JSON property `rtmpsIngestionAddress`
+        # @return [String]
+        attr_accessor :rtmps_ingestion_address
+      
         # The HTTP or RTMP stream name that YouTube assigns to the video stream.
         # Corresponds to the JSON property `streamName`
         # @return [String]
@@ -3339,21 +3440,24 @@ module Google
         def update!(**args)
           @backup_ingestion_address = args[:backup_ingestion_address] if args.key?(:backup_ingestion_address)
           @ingestion_address = args[:ingestion_address] if args.key?(:ingestion_address)
+          @rtmps_backup_ingestion_address = args[:rtmps_backup_ingestion_address] if args.key?(:rtmps_backup_ingestion_address)
+          @rtmps_ingestion_address = args[:rtmps_ingestion_address] if args.key?(:rtmps_ingestion_address)
           @stream_name = args[:stream_name] if args.key?(:stream_name)
         end
       end
       
-      # 
+      # LINT.IfChange
+      # Describes an invideo branding.
       class InvideoBranding
         include Google::Apis::Core::Hashable
       
-        # 
+        # The bytes the uploaded image. Only used in api to youtube communication.
         # Corresponds to the JSON property `imageBytes`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :image_bytes
       
-        # 
+        # The url of the uploaded image. Only used in apiary to api communication.
         # Corresponds to the JSON property `imageUrl`
         # @return [String]
         attr_accessor :image_url
@@ -3364,7 +3468,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::InvideoPosition]
         attr_accessor :position
       
-        # 
+        # The channel to which this branding links. If not present it defaults to
+        # the current channel.
         # Corresponds to the JSON property `targetChannelId`
         # @return [String]
         attr_accessor :target_channel_id
@@ -3414,8 +3519,8 @@ module Google
         end
       end
       
-      # Describes an invideo promotion campaign consisting of multiple promoted items.
-      # A campaign belongs to a single channel_id.
+      # Describes an invideo promotion campaign consisting of multiple promoted
+      # items. A campaign belongs to a single channel_id.
       class InvideoPromotion
         include Google::Apis::Core::Hashable
       
@@ -3435,10 +3540,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::InvideoPosition]
         attr_accessor :position
       
-        # Indicates whether the channel's promotional campaign uses "smart timing." This
-        # feature attempts to show promotions at a point in the video when they are more
-        # likely to be clicked and less likely to disrupt the viewing experience. This
-        # feature also picks up a single promotion to show on each video.
+        # Indicates whether the channel's promotional campaign uses "smart timing."
+        # This feature attempts to show promotions at a point in the video when they
+        # are more likely to be clicked and less likely to disrupt the viewing
+        # experience. This feature also picks up a single promotion to show on each
+        # video.
         # Corresponds to the JSON property `useSmartTiming`
         # @return [Boolean]
         attr_accessor :use_smart_timing
@@ -3467,17 +3573,18 @@ module Google
         # @return [Fixnum]
         attr_accessor :duration_ms
       
-        # Defines the time at which the promotion will appear. Depending on the value of
-        # type the value of the offsetMs field will represent a time offset from the
-        # start or from the end of the video, expressed in milliseconds.
+        # Defines the time at which the promotion will appear. Depending on the value
+        # of <code>type</code> the value of the <code>offsetMs</code> field will
+        # represent a time offset from the start or from the end of the video,
+        # expressed in milliseconds.
         # Corresponds to the JSON property `offsetMs`
         # @return [Fixnum]
         attr_accessor :offset_ms
       
-        # Describes a timing type. If the value is offsetFromStart, then the offsetMs
-        # field represents an offset from the start of the video. If the value is
-        # offsetFromEnd, then the offsetMs field represents an offset from the end of
-        # the video.
+        # Describes a timing type. If the value is <code>offsetFromStart</code>, then
+        # the <code>offsetMs</code> field represents an offset from the start of the
+        # video. If the value is <code>offsetFromEnd</code>, then the
+        # <code>offsetMs</code> field represents an offset from the end of the video.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -3517,7 +3624,7 @@ module Google
       class LevelDetails
         include Google::Apis::Core::Hashable
       
-        # 
+        # The name that should be used when referring to this level.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -3532,8 +3639,8 @@ module Google
         end
       end
       
-      # A liveBroadcast resource represents an event that will be streamed, via live
-      # video, on YouTube.
+      # A <code><strong>liveBroadcast</strong></code> resource represents an event
+      # that will be streamed, via live video, on YouTube.
       class LiveBroadcast
         include Google::Apis::Core::Hashable
       
@@ -3552,14 +3659,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveBroadcast".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveBroadcast"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the event, including its title,
-        # description, start time, and end time.
+        # Basic broadcast information.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::LiveBroadcastSnippet]
         attr_accessor :snippet
@@ -3570,7 +3676,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::LiveBroadcastStatistics]
         attr_accessor :statistics
       
-        # The status object contains information about the event's status.
+        # Live broadcast state.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::YoutubeV3::LiveBroadcastStatus]
         attr_accessor :status
@@ -3595,15 +3701,17 @@ module Google
       class LiveBroadcastContentDetails
         include Google::Apis::Core::Hashable
       
-        # This value uniquely identifies the live stream bound to the broadcast.
+        # This value uniquely identifies the
+        # <code><a href="/youtube/v3/live/docs/liveStreams">live stream</a></code>
+        # bound to the broadcast.
         # Corresponds to the JSON property `boundStreamId`
         # @return [String]
         attr_accessor :bound_stream_id
       
-        # The date and time that the live stream referenced by boundStreamId was last
-        # updated.
+        # The date and time that the live stream referenced by
+        # <code>boundStreamId</code> was last updated.
         # Corresponds to the JSON property `boundStreamLastUpdateTimeMs`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :bound_stream_last_update_time_ms
       
         # 
@@ -3612,40 +3720,45 @@ module Google
         attr_accessor :closed_captions_type
       
         # This setting indicates whether auto start is enabled for this broadcast.
+        # The default value for this property is <code>false</code>.<br><br>
+        # This setting can only be used by Events.
         # Corresponds to the JSON property `enableAutoStart`
         # @return [Boolean]
         attr_accessor :enable_auto_start
         alias_method :enable_auto_start?, :enable_auto_start
       
-        # 
+        # This setting indicates whether auto stop is enabled for this broadcast.
+        # The default value for this property is <code>false</code>.<br><br>
+        # This setting can only be used by Events.
         # Corresponds to the JSON property `enableAutoStop`
         # @return [Boolean]
         attr_accessor :enable_auto_stop
         alias_method :enable_auto_stop?, :enable_auto_stop
       
-        # This setting indicates whether HTTP POST closed captioning is enabled for this
-        # broadcast. The ingestion URL of the closed captions is returned through the
-        # liveStreams API. This is mutually exclusive with using the
-        # closed_captions_type property, and is equivalent to setting
-        # closed_captions_type to CLOSED_CAPTIONS_HTTP_POST.
+        # This setting indicates whether HTTP POST closed captioning is enabled for
+        # this broadcast. The ingestion URL of the closed captions is returned
+        # through the liveStreams API.  This is mutually exclusive with using the
+        # <code>closed_captions_type</code> property, and is equivalent to setting
+        # <code>closed_captions_type</code> to CLOSED_CAPTIONS_HTTP_POST.
         # Corresponds to the JSON property `enableClosedCaptions`
         # @return [Boolean]
         attr_accessor :enable_closed_captions
         alias_method :enable_closed_captions?, :enable_closed_captions
       
-        # This setting indicates whether YouTube should enable content encryption for
-        # the broadcast.
+        # This setting indicates whether YouTube should enable content encryption
+        # for the broadcast.
         # Corresponds to the JSON property `enableContentEncryption`
         # @return [Boolean]
         attr_accessor :enable_content_encryption
         alias_method :enable_content_encryption?, :enable_content_encryption
       
-        # This setting determines whether viewers can access DVR controls while watching
-        # the video. DVR controls enable the viewer to control the video playback
-        # experience by pausing, rewinding, or fast forwarding content. The default
-        # value for this property is true.
-        # Important: You must set the value to true and also set the enableArchive
-        # property's value to true if you want to make playback available immediately
+        # This setting determines whether viewers can access DVR controls while
+        # watching the video. DVR controls enable the viewer to control the video
+        # playback experience by pausing, rewinding, or fast forwarding content.
+        # The default value for this property is <code>true</code>.<br><br>
+        # <strong>Important:</strong> You must set the value to <code>true</code>
+        # and also set the <code>enableArchive</code> property's value to
+        # <code>true</code> if you want to make playback available immediately
         # after the broadcast ends.
         # Corresponds to the JSON property `enableDvr`
         # @return [Boolean]
@@ -3653,8 +3766,9 @@ module Google
         alias_method :enable_dvr?, :enable_dvr
       
         # This setting indicates whether the broadcast video can be played in an
-        # embedded player. If you choose to archive the video (using the enableArchive
-        # property), this setting will also apply to the archived video.
+        # embedded player. If you choose to archive the video (using the
+        # <code>enableArchive</code> property), this setting will also apply to
+        # the archived video.
         # Corresponds to the JSON property `enableEmbed`
         # @return [Boolean]
         attr_accessor :enable_embed
@@ -3666,17 +3780,20 @@ module Google
         attr_accessor :enable_low_latency
         alias_method :enable_low_latency?, :enable_low_latency
       
-        # If both this and enable_low_latency are set, they must match. LATENCY_NORMAL
-        # should match enable_low_latency=false LATENCY_LOW should match
-        # enable_low_latency=true LATENCY_ULTRA_LOW should have enable_low_latency
-        # omitted.
+        # If both this and enable_low_latency are set, they must match.
+        # LATENCY_NORMAL should match enable_low_latency=false
+        # LATENCY_LOW should match enable_low_latency=true
+        # LATENCY_ULTRA_LOW should have enable_low_latency omitted.
         # Corresponds to the JSON property `latencyPreference`
         # @return [String]
         attr_accessor :latency_preference
       
-        # The mesh for projecting the video if projection is mesh. The mesh value must
-        # be a UTF-8 string containing the base-64 encoding of 3D mesh data that follows
-        # the  Spherical Video V2 RFC specification for an mshp box, excluding the box
+        # The mesh for projecting the video if <code>projection</code> is
+        # <code>mesh</code>. The mesh value must be a UTF-8 string containing the
+        # base-64 encoding of 3D mesh data that follows the <a
+        # href="https://github.com/google/spatial-media/blob/master/docs/spherical-video-
+        # v2-rfc.md">
+        # Spherical Video V2 RFC specification</a> for an mshp box, excluding the box
         # size and type but including the following four reserved zero bytes for the
         # version and flags.
         # Corresponds to the JSON property `mesh`
@@ -3689,38 +3806,42 @@ module Google
         # @return [Google::Apis::YoutubeV3::MonitorStreamInfo]
         attr_accessor :monitor_stream
       
-        # The projection format of this broadcast. This defaults to rectangular.
+        # The projection format of this broadcast. This defaults to
+        # <code>rectangular</code>.
         # Corresponds to the JSON property `projection`
         # @return [String]
         attr_accessor :projection
       
-        # Automatically start recording after the event goes live. The default value for
-        # this property is true.
-        # Important: You must also set the enableDvr property's value to true if you
-        # want the playback to be available immediately after the broadcast ends. If you
-        # set this property's value to true but do not also set the enableDvr property
-        # to true, there may be a delay of around one day before the archived video will
-        # be available for playback.
+        # Automatically start recording after the event goes live.
+        # The default value for this property is <code>true</code>.<br><br>
+        # <strong>Important:</strong> You must also set the <code>enableDvr</code>
+        # property's value to
+        # <code>true</code> if you want the playback to be available immediately
+        # after the broadcast ends. If you set this property's value to
+        # <code>true</code> but do not also set the <code>enableDvr</code> property
+        # to <code>true</code>, there may be a delay of around one day before the
+        # archived video will be available for playback.
         # Corresponds to the JSON property `recordFromStart`
         # @return [Boolean]
         attr_accessor :record_from_start
         alias_method :record_from_start?, :record_from_start
       
-        # This setting indicates whether the broadcast should automatically begin with
-        # an in-stream slate when you update the broadcast's status to live. After
-        # updating the status, you then need to send a liveCuepoints.insert request that
-        # sets the cuepoint's eventState to end to remove the in-stream slate and make
-        # your broadcast stream visible to viewers.
+        # This setting indicates whether the broadcast should automatically begin
+        # with an <a
+        # href="/youtube/v3/live/getting-started#Displaying_Slates">in-stream
+        # slate</a> when you update the broadcast's status to <code>live</code>.
+        # After updating the status, you then need to send a
+        # <code><a
+        # href="/youtube/v3/live/docs/liveCuepoints/insert">liveCuepoints.insert</a></
+        # code>
+        # request that sets the cuepoint's <code>eventState</code> to
+        # <code>end</code> to remove the in-stream slate and make your broadcast
+        # stream visible to viewers.
         # Corresponds to the JSON property `startWithSlate`
         # @return [Boolean]
         attr_accessor :start_with_slate
         alias_method :start_with_slate?, :start_with_slate
       
-        # 
-        # Corresponds to the JSON property `stereoLayout`
-        # @return [String]
-        attr_accessor :stereo_layout
-      
         def initialize(**args)
            update!(**args)
         end
@@ -3743,7 +3864,6 @@ module Google
           @projection = args[:projection] if args.key?(:projection)
           @record_from_start = args[:record_from_start] if args.key?(:record_from_start)
           @start_with_slate = args[:start_with_slate] if args.key?(:start_with_slate)
-          @stereo_layout = args[:stereo_layout] if args.key?(:stereo_layout)
         end
       end
       
@@ -3766,14 +3886,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::LiveBroadcast>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveBroadcastListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveBroadcastListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -3784,8 +3904,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -3795,7 +3915,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -3818,43 +3938,43 @@ module Google
         end
       end
       
-      # 
+      # Basic broadcast information.
       class LiveBroadcastSnippet
         include Google::Apis::Core::Hashable
       
-        # The date and time that the broadcast actually ended. This information is only
-        # available once the broadcast's state is complete. The value is specified in
-        # ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the broadcast actually ended. This information is
+        # only available once the broadcast's state is <code>complete</code>. The
+        # value is specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `actualEndTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :actual_end_time
       
         # The date and time that the broadcast actually started. This information is
-        # only available once the broadcast's state is live. The value is specified in
-        # ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # only available once the broadcast's state is <code>live</code>. The
+        # value is specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `actualStartTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :actual_start_time
       
-        # 
-        # Corresponds to the JSON property `broadcastType`
-        # @return [String]
-        attr_accessor :broadcast_type
-      
-        # The ID that YouTube uses to uniquely identify the channel that is publishing
-        # the broadcast.
+        # The ID that YouTube uses to uniquely identify the channel that
+        # is publishing the broadcast.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
       
-        # The broadcast's description. As with the title, you can set this field by
-        # modifying the broadcast resource or by setting the description field of the
-        # corresponding video resource.
+        # The broadcast's description. As with the <code>title</code>, you can set
+        # this field by modifying the broadcast resource or by setting the
+        # <code><a
+        # href="/youtube/v3/docs/videos#snippet.description">description</a></code>
+        # field of the corresponding video resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # Indicates whether this broadcast is the default broadcast.
+        # Internal only.
         # Corresponds to the JSON property `isDefaultBroadcast`
         # @return [Boolean]
         attr_accessor :is_default_broadcast
@@ -3866,21 +3986,25 @@ module Google
         attr_accessor :live_chat_id
       
         # The date and time that the broadcast was added to YouTube's live broadcast
-        # schedule. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # schedule. The value is specified in
+        # <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
-        # The date and time that the broadcast is scheduled to end. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the broadcast is scheduled to end. The value
+        # is specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `scheduledEndTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :scheduled_end_time
       
-        # The date and time that the broadcast is scheduled to start. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the broadcast is scheduled to start. The value
+        # is specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `scheduledStartTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :scheduled_start_time
       
         # Internal representation of thumbnails for a YouTube resource.
@@ -3888,9 +4012,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::ThumbnailDetails]
         attr_accessor :thumbnails
       
-        # The broadcast's title. Note that the broadcast represents exactly one YouTube
-        # video. You can set this field by modifying the broadcast resource or by
-        # setting the title field of the corresponding video resource.
+        # The broadcast's title. Note that the broadcast represents exactly one
+        # YouTube video. You can set this field by modifying the broadcast resource
+        # or by setting the
+        # <code><a href="/youtube/v3/docs/videos#snippet.title">title</a></code>
+        # field of the corresponding video resource.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -3903,7 +4029,6 @@ module Google
         def update!(**args)
           @actual_end_time = args[:actual_end_time] if args.key?(:actual_end_time)
           @actual_start_time = args[:actual_start_time] if args.key?(:actual_start_time)
-          @broadcast_type = args[:broadcast_type] if args.key?(:broadcast_type)
           @channel_id = args[:channel_id] if args.key?(:channel_id)
           @description = args[:description] if args.key?(:description)
           @is_default_broadcast = args[:is_default_broadcast] if args.key?(:is_default_broadcast)
@@ -3921,22 +4046,12 @@ module Google
       class LiveBroadcastStatistics
         include Google::Apis::Core::Hashable
       
-        # The number of viewers currently watching the broadcast. The property and its
-        # value will be present if the broadcast has current viewers and the broadcast
-        # owner has not hidden the viewcount for the video. Note that YouTube stops
-        # tracking the number of concurrent viewers for a broadcast when the broadcast
-        # ends. So, this property would not identify the number of viewers watching an
-        # archived video of a live broadcast that already ended.
-        # Corresponds to the JSON property `concurrentViewers`
-        # @return [Fixnum]
-        attr_accessor :concurrent_viewers
-      
         # The total number of live chat messages currently on the broadcast. The
-        # property and its value will be present if the broadcast is public, has the
-        # live chat feature enabled, and has at least one message. Note that this field
-        # will not be filled after the broadcast ends. So this property would not
-        # identify the number of chat messages for an archived video of a completed live
-        # broadcast.
+        # property and its value will be present if the broadcast is public, has
+        # the live chat feature enabled, and has at least one message. Note that
+        # this field will not be filled after the broadcast ends. So this property
+        # would not identify the number of chat messages for an archived video of a
+        # completed live broadcast.
         # Corresponds to the JSON property `totalChatCount`
         # @return [Fixnum]
         attr_accessor :total_chat_count
@@ -3947,17 +4062,18 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @concurrent_viewers = args[:concurrent_viewers] if args.key?(:concurrent_viewers)
           @total_chat_count = args[:total_chat_count] if args.key?(:total_chat_count)
         end
       end
       
-      # 
+      # Live broadcast state.
       class LiveBroadcastStatus
         include Google::Apis::Core::Hashable
       
         # The broadcast's status. The status can be updated using the API's
-        # liveBroadcasts.transition method.
+        # <code><a
+        # href="/youtube/v3/live/docs/liveBroadcasts/transition"
+        # >liveBroadcasts.transition</a></code> method.
         # Corresponds to the JSON property `lifeCycleStatus`
         # @return [String]
         attr_accessor :life_cycle_status
@@ -3967,17 +4083,21 @@ module Google
         # @return [String]
         attr_accessor :live_broadcast_priority
       
-        # 
+        # Whether the broadcast is made for kids or not, decided by YouTube instead
+        # of the creator. This field is read only.
         # Corresponds to the JSON property `madeForKids`
         # @return [Boolean]
         attr_accessor :made_for_kids
         alias_method :made_for_kids?, :made_for_kids
       
-        # The broadcast's privacy status. Note that the broadcast represents exactly one
-        # YouTube video, so the privacy settings are identical to those supported for
-        # videos. In addition, you can set this field by modifying the broadcast
-        # resource or by setting the privacyStatus field of the corresponding video
-        # resource.
+        # The broadcast's privacy status. Note that the broadcast represents
+        # exactly one YouTube video, so the privacy settings are identical to
+        # those supported for videos. In addition, you can set this field by
+        # modifying the broadcast resource or by setting the
+        # <code><a
+        # href="/youtube/v3/docs/videos#status.privacyStatus"
+        # >privacyStatus</a></code>
+        # field of the corresponding video resource.
         # Corresponds to the JSON property `privacyStatus`
         # @return [String]
         attr_accessor :privacy_status
@@ -3987,7 +4107,8 @@ module Google
         # @return [String]
         attr_accessor :recording_status
       
-        # 
+        # This field will be set to True if the creator declares the broadcast to be
+        # kids only: go/live-cw-work.
         # Corresponds to the JSON property `selfDeclaredMadeForKids`
         # @return [Boolean]
         attr_accessor :self_declared_made_for_kids
@@ -4008,7 +4129,7 @@ module Google
         end
       end
       
-      # A liveChatBan resource represents a ban for a YouTube live chat.
+      # A `__liveChatBan__` resource represents a ban for a YouTube live chat.
       class LiveChatBan
         include Google::Apis::Core::Hashable
       
@@ -4022,13 +4143,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveChatBan".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#liveChatBan"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the ban.
+        # The `snippet` object contains basic details about the ban.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::LiveChatBanSnippet]
         attr_accessor :snippet
@@ -4120,12 +4241,13 @@ module Google
         end
       end
       
-      # A liveChatMessage resource represents a chat message in a YouTube Live Chat.
+      # A <code><strong>liveChatMessage</strong></code> resource represents a chat
+      # message in a YouTube Live Chat.
       class LiveChatMessage
         include Google::Apis::Core::Hashable
       
-        # The authorDetails object contains basic details about the user that posted
-        # this message.
+        # The <code>authorDetails</code> object contains basic details about the
+        # user that posted this message.
         # Corresponds to the JSON property `authorDetails`
         # @return [Google::Apis::YoutubeV3::LiveChatMessageAuthorDetails]
         attr_accessor :author_details
@@ -4140,13 +4262,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveChatMessage".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveChatMessage"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the message.
+        # The <code>snippet</code> object contains basic details about the message.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::LiveChatMessageSnippet]
         attr_accessor :snippet
@@ -4263,27 +4385,27 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of live chat messages.
+        # 
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::LiveChatMessage>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveChatMessageListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveChatMessageListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
         # The date and time when the underlying stream went offline. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `offlineAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :offline_at
       
         # Paging details for lists of resources, including total number of items
@@ -4302,7 +4424,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -4349,26 +4471,28 @@ module Google
       class LiveChatMessageSnippet
         include Google::Apis::Core::Hashable
       
-        # The ID of the user that authored this message, this field is not always filled.
-        # textMessageEvent - the user that wrote the message fanFundingEvent - the user
-        # that funded the broadcast newSponsorEvent - the user that just became a
-        # sponsor messageDeletedEvent - the moderator that took the action
+        # The ID of the user that authored this message, this field is not always
+        # filled.
+        # textMessageEvent - the user that wrote the message
+        # fanFundingEvent - the user that funded the broadcast
+        # newSponsorEvent - the user that just became a sponsor
+        # messageDeletedEvent - the moderator that took the action
         # messageRetractedEvent - the author that retracted their message
-        # userBannedEvent - the moderator that took the action superChatEvent - the user
-        # that made the purchase
+        # userBannedEvent - the moderator that took the action
+        # superChatEvent - the user that made the purchase
         # Corresponds to the JSON property `authorChannelId`
         # @return [String]
         attr_accessor :author_channel_id
       
-        # Contains a string that can be displayed to the user. If this field is not
-        # present the message is silent, at the moment only messages of type TOMBSTONE
-        # and CHAT_ENDED_EVENT are silent.
+        # Contains a string that can be displayed to the user.
+        # If this field is not present the message is silent, at the moment only
+        # messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
         # Corresponds to the JSON property `displayMessage`
         # @return [String]
         attr_accessor :display_message
       
-        # Details about the funding event, this is only set if the type is '
-        # fanFundingEvent'.
+        # Details about the funding event, this is only set if the type is
+        # 'fanFundingEvent'.
         # Corresponds to the JSON property `fanFundingEventDetails`
         # @return [Google::Apis::YoutubeV3::LiveChatFanFundingEventDetails]
         attr_accessor :fan_funding_event_details
@@ -4394,52 +4518,33 @@ module Google
         # @return [Google::Apis::YoutubeV3::LiveChatMessageRetractedDetails]
         attr_accessor :message_retracted_details
       
-        # 
-        # Corresponds to the JSON property `pollClosedDetails`
-        # @return [Google::Apis::YoutubeV3::LiveChatPollClosedDetails]
-        attr_accessor :poll_closed_details
-      
-        # 
-        # Corresponds to the JSON property `pollEditedDetails`
-        # @return [Google::Apis::YoutubeV3::LiveChatPollEditedDetails]
-        attr_accessor :poll_edited_details
-      
-        # 
-        # Corresponds to the JSON property `pollOpenedDetails`
-        # @return [Google::Apis::YoutubeV3::LiveChatPollOpenedDetails]
-        attr_accessor :poll_opened_details
-      
-        # 
-        # Corresponds to the JSON property `pollVotedDetails`
-        # @return [Google::Apis::YoutubeV3::LiveChatPollVotedDetails]
-        attr_accessor :poll_voted_details
-      
         # The date and time when the message was orignally published. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
-        # Details about the Super Chat event, this is only set if the type is '
-        # superChatEvent'.
+        # Details about the Super Chat event, this is only set if the type is
+        # 'superChatEvent'.
         # Corresponds to the JSON property `superChatDetails`
         # @return [Google::Apis::YoutubeV3::LiveChatSuperChatDetails]
         attr_accessor :super_chat_details
       
-        # Details about the Super Sticker event, this is only set if the type is '
-        # superStickerEvent'.
+        # Details about the Super Sticker event, this is only set if the type is
+        # 'superStickerEvent'.
         # Corresponds to the JSON property `superStickerDetails`
         # @return [Google::Apis::YoutubeV3::LiveChatSuperStickerDetails]
         attr_accessor :super_sticker_details
       
-        # Details about the text message, this is only set if the type is '
-        # textMessageEvent'.
+        # Details about the text message, this is only set if the type is
+        # 'textMessageEvent'.
         # Corresponds to the JSON property `textMessageDetails`
         # @return [Google::Apis::YoutubeV3::LiveChatTextMessageDetails]
         attr_accessor :text_message_details
       
-        # The type of message, this will always be present, it determines the contents
-        # of the message as well as which fields will be present.
+        # The type of message, this will always be present, it determines the
+        # contents of the message as well as which fields will be present.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4462,10 +4567,6 @@ module Google
           @live_chat_id = args[:live_chat_id] if args.key?(:live_chat_id)
           @message_deleted_details = args[:message_deleted_details] if args.key?(:message_deleted_details)
           @message_retracted_details = args[:message_retracted_details] if args.key?(:message_retracted_details)
-          @poll_closed_details = args[:poll_closed_details] if args.key?(:poll_closed_details)
-          @poll_edited_details = args[:poll_edited_details] if args.key?(:poll_edited_details)
-          @poll_opened_details = args[:poll_opened_details] if args.key?(:poll_opened_details)
-          @poll_voted_details = args[:poll_voted_details] if args.key?(:poll_voted_details)
           @published_at = args[:published_at] if args.key?(:published_at)
           @super_chat_details = args[:super_chat_details] if args.key?(:super_chat_details)
           @super_sticker_details = args[:super_sticker_details] if args.key?(:super_sticker_details)
@@ -4475,9 +4576,9 @@ module Google
         end
       end
       
-      # A liveChatModerator resource represents a moderator for a YouTube live chat. A
-      # chat moderator has the ability to ban/unban users from a chat, remove message,
-      # etc.
+      # A <code><strong>liveChatModerator</strong></code> resource represents a
+      # moderator for a YouTube live chat. A chat moderator has the ability to
+      # ban/unban users from a chat, remove message, etc.
       class LiveChatModerator
         include Google::Apis::Core::Hashable
       
@@ -4491,13 +4592,14 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveChatModerator".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveChatModerator"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the moderator.
+        # The <code>snippet</code> object contains basic details about the
+        # moderator.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::LiveChatModeratorSnippet]
         attr_accessor :snippet
@@ -4534,14 +4636,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::LiveChatModerator>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveChatModeratorListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveChatModeratorListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -4552,8 +4654,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -4563,7 +4665,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -4611,137 +4713,6 @@ module Google
         end
       end
       
-      # 
-      class LiveChatPollClosedDetails
-        include Google::Apis::Core::Hashable
-      
-        # The id of the poll that was closed.
-        # Corresponds to the JSON property `pollId`
-        # @return [String]
-        attr_accessor :poll_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @poll_id = args[:poll_id] if args.key?(:poll_id)
-        end
-      end
-      
-      # 
-      class LiveChatPollEditedDetails
-        include Google::Apis::Core::Hashable
-      
-        # 
-        # Corresponds to the JSON property `id`
-        # @return [String]
-        attr_accessor :id
-      
-        # 
-        # Corresponds to the JSON property `items`
-        # @return [Array<Google::Apis::YoutubeV3::LiveChatPollItem>]
-        attr_accessor :items
-      
-        # 
-        # Corresponds to the JSON property `prompt`
-        # @return [String]
-        attr_accessor :prompt
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @id = args[:id] if args.key?(:id)
-          @items = args[:items] if args.key?(:items)
-          @prompt = args[:prompt] if args.key?(:prompt)
-        end
-      end
-      
-      # 
-      class LiveChatPollItem
-        include Google::Apis::Core::Hashable
-      
-        # Plain text description of the item.
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        # 
-        # Corresponds to the JSON property `itemId`
-        # @return [String]
-        attr_accessor :item_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @description = args[:description] if args.key?(:description)
-          @item_id = args[:item_id] if args.key?(:item_id)
-        end
-      end
-      
-      # 
-      class LiveChatPollOpenedDetails
-        include Google::Apis::Core::Hashable
-      
-        # 
-        # Corresponds to the JSON property `id`
-        # @return [String]
-        attr_accessor :id
-      
-        # 
-        # Corresponds to the JSON property `items`
-        # @return [Array<Google::Apis::YoutubeV3::LiveChatPollItem>]
-        attr_accessor :items
-      
-        # 
-        # Corresponds to the JSON property `prompt`
-        # @return [String]
-        attr_accessor :prompt
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @id = args[:id] if args.key?(:id)
-          @items = args[:items] if args.key?(:items)
-          @prompt = args[:prompt] if args.key?(:prompt)
-        end
-      end
-      
-      # 
-      class LiveChatPollVotedDetails
-        include Google::Apis::Core::Hashable
-      
-        # The poll item the user chose.
-        # Corresponds to the JSON property `itemId`
-        # @return [String]
-        attr_accessor :item_id
-      
-        # The poll the user voted on.
-        # Corresponds to the JSON property `pollId`
-        # @return [String]
-        attr_accessor :poll_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @item_id = args[:item_id] if args.key?(:item_id)
-          @poll_id = args[:poll_id] if args.key?(:poll_id)
-        end
-      end
-      
       # 
       class LiveChatSuperChatDetails
         include Google::Apis::Core::Hashable
@@ -4761,8 +4732,8 @@ module Google
         # @return [String]
         attr_accessor :currency
       
-        # The tier in which the amount belongs. Lower amounts belong to lower tiers. The
-        # lowest tier is 1.
+        # The tier in which the amount belongs. Lower amounts belong to lower
+        # tiers. The lowest tier is <code>1</code>.
         # Corresponds to the JSON property `tier`
         # @return [Fixnum]
         attr_accessor :tier
@@ -4810,8 +4781,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::SuperStickerMetadata]
         attr_accessor :super_sticker_metadata
       
-        # The tier in which the amount belongs. Lower amounts belong to lower tiers. The
-        # lowest tier is 1.
+        # The tier in which the amount belongs. Lower amounts belong to lower
+        # tiers. The lowest tier is <code>1</code>.
         # Corresponds to the JSON property `tier`
         # @return [Fixnum]
         attr_accessor :tier
@@ -4853,8 +4824,8 @@ module Google
       class LiveChatUserBannedMessageDetails
         include Google::Apis::Core::Hashable
       
-        # The duration of the ban. This property is only present if the banType is
-        # temporary.
+        # The duration of the ban. This property is only present if the
+        # <code>banType</code> is <code>temporary</code>.
         # Corresponds to the JSON property `banDurationSeconds`
         # @return [Fixnum]
         attr_accessor :ban_duration_seconds
@@ -4905,14 +4876,14 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveStream".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveStream"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the stream, including its
-        # channel, title, and description.
+        # The <code>snippet</code> object contains basic details about the
+        # stream, including its channel, title, and description.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::LiveStreamSnippet]
         attr_accessor :snippet
@@ -4984,19 +4955,25 @@ module Google
         # @return [String]
         attr_accessor :closed_captions_ingestion_url
       
-        # Indicates whether the stream is reusable, which means that it can be bound to
-        # multiple broadcasts. It is common for broadcasters to reuse the same stream
-        # for many different broadcasts if those broadcasts occur at different times.
-        # If you set this value to false, then the stream will not be reusable, which
-        # means that it can only be bound to one broadcast. Non-reusable streams differ
-        # from reusable streams in the following ways:
-        # - A non-reusable stream can only be bound to one broadcast.
-        # - A non-reusable stream might be deleted by an automated process after the
-        # broadcast ends.
-        # - The  liveStreams.list method does not list non-reusable streams if you call
-        # the method and set the mine parameter to true. The only way to use that method
-        # to retrieve the resource for a non-reusable stream is to use the id parameter
-        # to identify the stream.
+        # Indicates whether the stream is reusable, which means that it
+        # can be bound to multiple broadcasts. It is common for
+        # broadcasters to reuse the same stream for many different
+        # broadcasts if those broadcasts occur at different times.<br><br>
+        # If you set this value to <code>false</code>, then the stream
+        # will not be reusable, which means that it can only be bound to
+        # one broadcast. Non-reusable streams differ from reusable streams in the
+        # following ways:
+        # <ul>
+        # <li>A non-reusable stream can only be bound to one broadcast.</li>
+        # <li>A non-reusable stream might be deleted by an automated process
+        # after the broadcast ends.</li>
+        # <li>The <code><a href="/youtube/v3/live/docs/liveStreams/list">
+        # liveStreams.list</a></code> method does not list non-reusable streams
+        # if you call the method and set the <code>mine</code> parameter to
+        # <code>true</code>. The only way to use that method to retrieve the
+        # resource for a non-reusable stream is to use the <code>id</code>
+        # parameter to identify the stream.</li>
+        # </ul>
         # Corresponds to the JSON property `isReusable`
         # @return [Boolean]
         attr_accessor :is_reusable
@@ -5063,14 +5040,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::LiveStream>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # liveStreamListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#liveStreamListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -5081,8 +5058,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -5092,7 +5069,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -5119,13 +5096,14 @@ module Google
       class LiveStreamSnippet
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the channel that is transmitting
-        # the stream.
+        # The ID that YouTube uses to uniquely identify the channel that
+        # is transmitting the stream.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
       
-        # The stream's description. The value cannot be longer than 10000 characters.
+        # The stream's description. The value cannot be longer than 10000
+        # characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -5136,10 +5114,11 @@ module Google
         attr_accessor :is_default_stream
         alias_method :is_default_stream?, :is_default_stream
       
-        # The date and time that the stream was created. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the stream was created. The value is specified in
+        # <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # The stream's title. The value must be between 1 and 128 characters long.
@@ -5242,8 +5221,9 @@ module Google
         end
       end
       
-      # A member resource represents a member for a YouTube channel. A member provides
-      # recurring monetary support to a creator and receives special benefits.
+      # A <code><strong>member</strong></code> resource represents a member for a
+      # YouTube channel. A member provides recurring monetary support to a creator
+      # and receives special benefits.
       class Member
         include Google::Apis::Core::Hashable
       
@@ -5252,13 +5232,13 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # member".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#member"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the member.
+        # The <code>snippet</code> object contains basic details about the member.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::MemberSnippet]
         attr_accessor :snippet
@@ -5294,14 +5274,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::Member>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # memberListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#memberListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -5317,7 +5297,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -5386,7 +5366,8 @@ module Google
         # @return [String]
         attr_accessor :highest_accessible_level
       
-        # Display name of the highest level that the user has access to at the moment.
+        # Display name for the highest level that the user has access to at the
+        # moment.
         # Corresponds to the JSON property `highestAccessibleLevelDisplayName`
         # @return [String]
         attr_accessor :highest_accessible_level_display_name
@@ -5420,13 +5401,14 @@ module Google
       class MembershipsDuration
         include Google::Apis::Core::Hashable
       
-        # The date and time when the user became a continuous member across all levels.
+        # The date and time when the user became a continuous member across all
+        # levels.
         # Corresponds to the JSON property `memberSince`
         # @return [String]
         attr_accessor :member_since
       
-        # The cumulative time the user has been a member across all levels in complete
-        # months (the time is rounded down to the nearest integer).
+        # The cumulative time the user has been a member across all levels in
+        # complete months (the time is rounded down to the nearest integer).
         # Corresponds to the JSON property `memberTotalDurationMonths`
         # @return [Fixnum]
         attr_accessor :member_total_duration_months
@@ -5446,18 +5428,19 @@ module Google
       class MembershipsDurationAtLevel
         include Google::Apis::Core::Hashable
       
-        # Pricing level id.
+        # Pricing level ID.
         # Corresponds to the JSON property `level`
         # @return [String]
         attr_accessor :level
       
-        # The date and time when the user became a continuous member for the given level.
+        # The date and time when the user became a continuous member for the given
+        # level.
         # Corresponds to the JSON property `memberSince`
         # @return [String]
         attr_accessor :member_since
       
-        # The cumulative time the user has been a member for the given level in complete
-        # months (the time is rounded down to the nearest integer).
+        # The cumulative time the user has been a member for the given level in
+        # complete months (the time is rounded down to the nearest integer).
         # Corresponds to the JSON property `memberTotalDurationMonths`
         # @return [Fixnum]
         attr_accessor :member_total_duration_months
@@ -5474,10 +5457,10 @@ module Google
         end
       end
       
-      # A membershipsLevel resource represents an offer made by YouTube creators for
-      # their fans. Users can become members of the channel by joining one of the
-      # available levels. They will provide recurring monetary support and receives
-      # special benefits.
+      # A <code><strong>membershipsLevel</strong></code> resource represents an offer
+      # made by YouTube creators for their fans. Users can become members of the
+      # channel by joining one of the available levels. They will provide recurring
+      # monetary support and receives special benefits.
       class MembershipsLevel
         include Google::Apis::Core::Hashable
       
@@ -5491,13 +5474,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # membershipsLevel".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#membershipsLevelListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the level.
+        # The <code>snippet</code> object contains basic details about the level.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::MembershipsLevelSnippet]
         attr_accessor :snippet
@@ -5534,13 +5517,13 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::MembershipsLevel>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # membershipsLevelListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#membershipsLevelListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -5568,7 +5551,7 @@ module Google
         # @return [String]
         attr_accessor :creator_channel_id
       
-        # 
+        # Details about the pricing level.
         # Corresponds to the JSON property `levelDetails`
         # @return [Google::Apis::YoutubeV3::LevelDetails]
         attr_accessor :level_details
@@ -5588,8 +5571,10 @@ module Google
       class MonitorStreamInfo
         include Google::Apis::Core::Hashable
       
-        # If you have set the enableMonitorStream property to true, then this property
-        # determines the length of the live broadcast delay.
+        # If you have set the
+        # <code><a href="#enableMonitorStream">enableMonitorStream</a></code>
+        # property to <code>true</code>, then this property determines the
+        # length of the live broadcast delay.
         # Corresponds to the JSON property `broadcastStreamDelayMs`
         # @return [Fixnum]
         attr_accessor :broadcast_stream_delay_ms
@@ -5599,15 +5584,16 @@ module Google
         # @return [String]
         attr_accessor :embed_html
       
-        # This value determines whether the monitor stream is enabled for the broadcast.
-        # If the monitor stream is enabled, then YouTube will broadcast the event
-        # content on a special stream intended only for the broadcaster's consumption.
-        # The broadcaster can use the stream to review the event content and also to
-        # identify the optimal times to insert cuepoints.
-        # You need to set this value to true if you intend to have a broadcast delay for
-        # your event.
-        # Note: This property cannot be updated once the broadcast is in the testing or
-        # live state.
+        # This value determines whether the monitor stream is enabled for the
+        # broadcast. If the monitor stream is enabled, then YouTube will
+        # broadcast the event content on a special stream intended only for
+        # the broadcaster's consumption. The broadcaster can use the stream
+        # to review the event content and also to identify the optimal times
+        # to insert cuepoints.<br><br>
+        # You need to set this value to <code>true</code> if you intend to have
+        # a broadcast delay for your event.<br><br>
+        # <strong>Note:</strong> This property cannot be updated once the
+        # broadcast is in the <code>testing</code> or <code>live</code> state.
         # Corresponds to the JSON property `enableMonitorStream`
         # @return [Boolean]
         attr_accessor :enable_monitor_stream
@@ -5625,50 +5611,6 @@ module Google
         end
       end
       
-      # Nonprofit information.
-      class Nonprofit
-        include Google::Apis::Core::Hashable
-      
-        # Id of the nonprofit.
-        # Corresponds to the JSON property `nonprofitId`
-        # @return [Google::Apis::YoutubeV3::NonprofitId]
-        attr_accessor :nonprofit_id
-      
-        # Legal name of the nonprofit.
-        # Corresponds to the JSON property `nonprofitLegalName`
-        # @return [String]
-        attr_accessor :nonprofit_legal_name
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @nonprofit_id = args[:nonprofit_id] if args.key?(:nonprofit_id)
-          @nonprofit_legal_name = args[:nonprofit_legal_name] if args.key?(:nonprofit_legal_name)
-        end
-      end
-      
-      # 
-      class NonprofitId
-        include Google::Apis::Core::Hashable
-      
-        # 
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @value = args[:value] if args.key?(:value)
-        end
-      end
-      
       # Paging details for lists of resources, including total number of items
       # available and number of resources returned in a single page.
       class PageInfo
@@ -5695,28 +5637,39 @@ module Google
         end
       end
       
-      # A playlist resource represents a YouTube playlist. A playlist is a collection
-      # of videos that can be viewed sequentially and shared with other users. A
-      # playlist can contain up to 200 videos, and YouTube does not limit the number
-      # of playlists that each user creates. By default, playlists are publicly
-      # visible to other users, but playlists can be public or private.
-      # YouTube also uses playlists to identify special collections of videos for a
+      # A <code><strong>playlist</strong></code> resource represents a YouTube
+      # playlist. A playlist is a collection of videos that can be viewed
+      # sequentially and shared with other users. A playlist can contain up to
+      # 200 videos, and YouTube does not limit the number of playlists that
+      # each user creates. By default, playlists are publicly visible to other
+      # users, but playlists can be public or private.  <br/><br/> YouTube
+      # also uses playlists to identify special collections of videos for a
       # channel, such as:
-      # - uploaded videos
-      # - favorite videos
-      # - positively rated (liked) videos
-      # - watch history
-      # - watch later  To be more specific, these lists are associated with a channel,
-      # which is a collection of a person, group, or company's videos, playlists, and
-      # other YouTube information. You can retrieve the playlist IDs for each of these
-      # lists from the  channel resource for a given channel.
-      # You can then use the   playlistItems.list method to retrieve any of those
-      # lists. You can also add or remove items from those lists by calling the
-      # playlistItems.insert and   playlistItems.delete methods.
+      # <ul>
+      # <li>uploaded videos</li>
+      # <li>favorite videos</li>
+      # <li>positively rated (liked) videos</li>
+      # <li>watch history</li>
+      # <li>watch later</li>
+      # </ul>
+      # To be more specific, these lists are associated with a channel, which
+      # is a collection of a person, group, or company's videos, playlists,
+      # and other YouTube information.  You can retrieve the playlist IDs for
+      # each of these lists from the <code><a
+      # href=\"/youtube/v3/docs/channels\"> channel resource</a></code> for a
+      # given channel.<br/><br/> You can then use the <code> <a
+      # href=\"/youtube/v3/docs/playlistItems/list\">
+      # playlistItems.list</a></code> method to retrieve any of those
+      # lists. You can also add or remove items from those lists by calling
+      # the <code> <a href=\"/youtube/v3/docs/playlistItems/insert\">
+      # playlistItems.insert</a></code> and <code> <a
+      # href=\"/youtube/v3/docs/playlistItems/delete\">
+      # playlistItems.delete</a></code> methods.
       class Playlist
         include Google::Apis::Core::Hashable
       
-        # The contentDetails object contains information like video count.
+        # The <code>contentDetails</code> object contains information like
+        # video count.
         # Corresponds to the JSON property `contentDetails`
         # @return [Google::Apis::YoutubeV3::PlaylistContentDetails]
         attr_accessor :content_details
@@ -5731,8 +5684,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # playlist".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#playlist"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -5742,8 +5695,8 @@ module Google
         # @return [Hash<String,Google::Apis::YoutubeV3::PlaylistLocalization>]
         attr_accessor :localizations
       
-        # The player object contains information that you would use to play the playlist
-        # in an embedded player.
+        # The <code>player</code> object contains information that you would use
+        # to play the playlist in an embedded player.
         # Corresponds to the JSON property `player`
         # @return [Google::Apis::YoutubeV3::PlaylistPlayer]
         attr_accessor :player
@@ -5753,7 +5706,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PlaylistSnippet]
         attr_accessor :snippet
       
-        # The status object contains status information for the playlist.
+        # The <code>status</code> object contains status information for the
+        # playlist.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::YoutubeV3::PlaylistStatus]
         attr_accessor :status
@@ -5794,30 +5748,41 @@ module Google
         end
       end
       
-      # A playlistItem resource identifies another resource, such as a video, that is
-      # included in a playlist. In addition, the playlistItem  resource contains
-      # details about the included resource that pertain specifically to how that
-      # resource is used in that playlist.
-      # YouTube uses playlists to identify special collections of videos for a channel,
-      # such as:
-      # - uploaded videos
-      # - favorite videos
-      # - positively rated (liked) videos
-      # - watch history
-      # - watch later  To be more specific, these lists are associated with a channel,
-      # which is a collection of a person, group, or company's videos, playlists, and
-      # other YouTube information.
-      # You can retrieve the playlist IDs for each of these lists from the  channel
-      # resource  for a given channel. You can then use the   playlistItems.list
-      # method to retrieve any of those lists. You can also add or remove items from
-      # those lists by calling the   playlistItems.insert and   playlistItems.delete
-      # methods. For example, if a user gives a positive rating to a video, you would
-      # insert that video into the liked videos playlist for that user's channel.
+      # A <code><strong>playlistItem</strong></code> resource identifies
+      # another resource, such as a video, that is included in a playlist. In
+      # addition, the <code>playlistItem </code> resource contains details
+      # about the included resource that pertain specifically to how that
+      # resource is used in that playlist.<br/><br/> YouTube uses playlists to
+      # identify special collections of videos for a channel, such as:
+      # <ul>
+      # <li>uploaded videos</li>
+      # <li>favorite videos</li>
+      # <li>positively rated (liked) videos</li>
+      # <li>watch history</li>
+      # <li>watch later</li>
+      # </ul>
+      # To be more specific, these lists are associated with a channel, which
+      # is a collection of a person, group, or company's videos, playlists,
+      # and other YouTube information.
+      # <br/><br/>
+      # You can retrieve the playlist IDs for each of these lists from the
+      # <code> <a href=\"/youtube/v3/docs/channels\">channel resource</a>
+      # </code> for a given channel. You can then use the <code> <a
+      # href=\"/youtube/v3/docs/playlistItems/list\">
+      # playlistItems.list</a></code> method to retrieve any of those
+      # lists. You can also add or remove items from those lists by calling
+      # the <code> <a href=\"/youtube/v3/docs/playlistItems/insert\">
+      # playlistItems.insert</a></code> and <code> <a
+      # href=\"/youtube/v3/docs/playlistItems/delete\">
+      # playlistItems.delete</a></code> methods. For example, if a user gives
+      # a positive rating to a video, you would insert that video into the
+      # liked videos playlist for that user's channel.
       class PlaylistItem
         include Google::Apis::Core::Hashable
       
-        # The contentDetails object is included in the resource if the included item is
-        # a YouTube video. The object contains additional information about the video.
+        # The <code>contentDetails</code> object is included in the resource if
+        # the included item is a YouTube video. The object contains additional
+        # information about the video.
         # Corresponds to the JSON property `contentDetails`
         # @return [Google::Apis::YoutubeV3::PlaylistItemContentDetails]
         attr_accessor :content_details
@@ -5832,13 +5797,15 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # playlistItem".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#playlistItem"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # Basic details about a playlist, including title, description and thumbnails.
+        # Basic details of a YouTube Playlist item provided by the author.
+        # Next ID: 13
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::PlaylistItemSnippet]
         attr_accessor :snippet
@@ -5868,9 +5835,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The time, measured in seconds from the start of the video, when the video
-        # should stop playing. (The playlist owner can specify the times when the video
-        # should start and stop playing when the video is played in the context of the
-        # playlist.) By default, assume that the video.endTime is the end of the video.
+        # should stop playing. (The playlist owner can specify the times when the
+        # video should start and stop playing when the video is played in the context
+        # of the playlist.) By default, assume that the <code>video.endTime</code> is
+        # the end of the video.
         # Corresponds to the JSON property `endAt`
         # @return [String]
         attr_accessor :end_at
@@ -5881,23 +5849,26 @@ module Google
         attr_accessor :note
       
         # The time, measured in seconds from the start of the video, when the video
-        # should start playing. (The playlist owner can specify the times when the video
-        # should start and stop playing when the video is played in the context of the
-        # playlist.) The default value is 0.
+        # should start playing. (The playlist owner can specify the times when the
+        # video should start and stop playing when the video is played in the context
+        # of the playlist.) The default value is <code>0</code>.
         # Corresponds to the JSON property `startAt`
         # @return [String]
         attr_accessor :start_at
       
-        # The ID that YouTube uses to uniquely identify a video. To retrieve the video
-        # resource, set the id query parameter to this value in your API request.
+        # The ID that YouTube uses to uniquely identify a video. To <a
+        # href="/youtube/v3/docs/video/list.html">retrieve the <code>video</code>
+        # resource</a>, set the <code>id</code> query parameter to this value in your
+        # API request.
         # Corresponds to the JSON property `videoId`
         # @return [String]
         attr_accessor :video_id
       
         # The date and time that the video was published to YouTube. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `videoPublishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :video_published_at
       
         def initialize(**args)
@@ -5918,7 +5889,7 @@ module Google
       class ListPlaylistItemsResponse
         include Google::Apis::Core::Hashable
       
-        # Etag of this resource.
+        # 
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -5933,14 +5904,15 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::PlaylistItem>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # playlistItemListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#playlistItemListResponse"</code>.
+        # Etag of this resource.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -5951,8 +5923,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -5962,7 +5934,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -5986,11 +5958,13 @@ module Google
       end
       
       # Basic details about a playlist, including title, description and thumbnails.
+      # Basic details of a YouTube Playlist item provided by the author.
+      # Next ID: 13
       class PlaylistItemSnippet
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the user that added the item to
-        # the playlist.
+        # The ID that YouTube uses to uniquely identify the user that added
+        # the item to the playlist.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -6005,23 +5979,24 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # The ID that YouTube uses to uniquely identify the playlist that the playlist
-        # item is in.
+        # The ID that YouTube uses to uniquely identify thGe playlist that the
+        # playlist item is in.
         # Corresponds to the JSON property `playlistId`
         # @return [String]
         attr_accessor :playlist_id
       
-        # The order in which the item appears in the playlist. The value uses a zero-
-        # based index, so the first item has a position of 0, the second item has a
-        # position of 1, and so forth.
+        # The order in which the item appears in the playlist. The value uses a
+        # zero-based index, so the first item has a position of <code>0</code>,
+        # the second item has a position of <code>1</code>, and so forth.
         # Corresponds to the JSON property `position`
         # @return [Fixnum]
         attr_accessor :position
       
         # The date and time that the item was added to the playlist. The value is
-        # specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # A resource id is a generic reference that points to another YouTube resource.
@@ -6090,19 +6065,19 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of playlists that match the request criteria.
+        # A list of playlists that match the request criteria
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::Playlist>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # playlistListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#playlistListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -6113,8 +6088,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -6124,7 +6099,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -6176,7 +6151,8 @@ module Google
       class PlaylistPlayer
         include Google::Apis::Core::Hashable
       
-        # An <iframe> tag that embeds a player that will play the playlist.
+        # An <code>&lt;iframe&gt;</code> tag that embeds a player that will
+        # play the playlist.
         # Corresponds to the JSON property `embedHtml`
         # @return [String]
         attr_accessor :embed_html
@@ -6195,8 +6171,8 @@ module Google
       class PlaylistSnippet
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the channel that published the
-        # playlist.
+        # The ID that YouTube uses to uniquely identify the channel that
+        # published the playlist.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -6221,10 +6197,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::PlaylistLocalization]
         attr_accessor :localized
       
-        # The date and time that the playlist was created. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the playlist was created. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # Keyword tags associated with the playlist.
@@ -6294,9 +6271,9 @@ module Google
         # @return [Google::Apis::YoutubeV3::PromotedItemId]
         attr_accessor :id
       
-        # If true, the content owner's name will be used when displaying the promotion.
-        # This field can only be set when the update is made on behalf of the content
-        # owner.
+        # If true, the content owner's name will be used when displaying the
+        # promotion. This field can only be set when the update is made on behalf of
+        # the content owner.
         # Corresponds to the JSON property `promotedByContentOwner`
         # @return [Boolean]
         attr_accessor :promoted_by_content_owner
@@ -6324,9 +6301,9 @@ module Google
       class PromotedItemId
         include Google::Apis::Core::Hashable
       
-        # If type is recentUpload, this field identifies the channel from which to take
-        # the recent upload. If missing, the channel is assumed to be the same channel
-        # for which the invideoPromotion is set.
+        # If type is recentUpload, this field identifies the channel from which to
+        # take the recent upload. If missing, the channel is assumed to be the same
+        # channel for which the invideoPromotion is set.
         # Corresponds to the JSON property `recentlyUploadedBy`
         # @return [String]
         attr_accessor :recently_uploaded_by
@@ -6337,15 +6314,15 @@ module Google
         attr_accessor :type
       
         # If the promoted item represents a video, this field represents the unique
-        # YouTube ID identifying it. This field will be present only if type has the
-        # value video.
+        # YouTube ID identifying it. This field will be present only if
+        # <code>type</code> has the value <code>video</code>.
         # Corresponds to the JSON property `videoId`
         # @return [String]
         attr_accessor :video_id
       
         # If the promoted item represents a website, this field represents the url
-        # pointing to the website. This field will be present only if type has the value
-        # website.
+        # pointing to the website. This field will be present only if
+        # <code>type</code> has the value <code>website</code>.
         # Corresponds to the JSON property `websiteUrl`
         # @return [String]
         attr_accessor :website_url
@@ -6392,9 +6369,9 @@ module Google
       class ResourceId
         include Google::Apis::Core::Hashable
       
-        # The ID that YouTube uses to uniquely identify the referred resource, if that
-        # resource is a channel. This property is only present if the resourceId.kind
-        # value is youtube#channel.
+        # The ID that YouTube uses to uniquely identify the referred resource, if
+        # that resource is a channel. This property is only present if the
+        # <code>resourceId.kind</code> value is <code>youtube#channel</code>.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -6404,16 +6381,16 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The ID that YouTube uses to uniquely identify the referred resource, if that
-        # resource is a playlist. This property is only present if the resourceId.kind
-        # value is youtube#playlist.
+        # The ID that YouTube uses to uniquely identify the referred resource, if
+        # that resource is a playlist. This property is only present if the
+        # <code>resourceId.kind</code> value is <code>youtube#playlist</code>.
         # Corresponds to the JSON property `playlistId`
         # @return [String]
         attr_accessor :playlist_id
       
-        # The ID that YouTube uses to uniquely identify the referred resource, if that
-        # resource is a video. This property is only present if the resourceId.kind
-        # value is youtube#video.
+        # The ID that YouTube uses to uniquely identify the referred resource, if
+        # that resource is a video. This property is only present if the
+        # <code>resourceId.kind</code> value is <code>youtube#video</code>.
         # Corresponds to the JSON property `videoId`
         # @return [String]
         attr_accessor :video_id
@@ -6445,19 +6422,19 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of results that match the search criteria.
+        # Pagination information for token pagination.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::SearchResult>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # searchListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#searchListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -6468,8 +6445,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -6484,7 +6461,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -6509,9 +6486,9 @@ module Google
       end
       
       # A search result contains information about a YouTube video, channel, or
-      # playlist that matches the search parameters specified in an API request. While
-      # a search result points to a uniquely identifiable resource, like a video, it
-      # does not have its own persistent data.
+      # playlist that matches the search parameters specified in an API request.
+      # While a search result points to a uniquely identifiable resource, like a
+      # video, it does not have its own persistent data.
       class SearchResult
         include Google::Apis::Core::Hashable
       
@@ -6525,8 +6502,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::ResourceId]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # searchResult".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#searchResult"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -6555,8 +6532,8 @@ module Google
       class SearchResultSnippet
         include Google::Apis::Core::Hashable
       
-        # The value that YouTube uses to uniquely identify the channel that published
-        # the resource that the search result identifies.
+        # The value that YouTube uses to uniquely identify the channel that
+        # published the resource that the search result identifies.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -6573,16 +6550,18 @@ module Google
         attr_accessor :description
       
         # It indicates if the resource (video or channel) has upcoming/active live
-        # broadcast content. Or it's "none" if there is not any upcoming/active live
-        # broadcasts.
+        # broadcast content. Or it's "none" if there is not any upcoming/active
+        # live broadcasts.
         # Corresponds to the JSON property `liveBroadcastContent`
         # @return [String]
         attr_accessor :live_broadcast_content
       
-        # The creation date and time of the resource that the search result identifies.
-        # The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The creation date and time of the resource that the search result
+        # identifies. The value is specified in <a
+        # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # Internal representation of thumbnails for a YouTube resource.
@@ -6611,8 +6590,9 @@ module Google
         end
       end
       
-      # A sponsor resource represents a sponsor for a YouTube channel. A sponsor
-      # provides recurring monetary support to a creator and receives special benefits.
+      # A `__sponsor__` resource represents a sponsor for a YouTube channel.  A
+      # sponsor provides recurring monetary support to a creator and receives special
+      # benefits.
       class Sponsor
         include Google::Apis::Core::Hashable
       
@@ -6621,13 +6601,13 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # sponsor".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#sponsor"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the sponsor.
+        # The `snippet` object contains basic details about the sponsor.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::SponsorSnippet]
         attr_accessor :snippet
@@ -6663,14 +6643,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::Sponsor>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # sponsorListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#sponsorListResponse".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the `pageToken` parameter to
+        # retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -6686,7 +6666,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The `visitorId` identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -6727,10 +6707,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::ChannelProfileDetails]
         attr_accessor :sponsor_details
       
-        # The date and time when the user became a sponsor. The value is specified in
-        # ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time when the user became a sponsor. The value is
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (`YYYY-MM-DDThh:mm:ss.sZ`) format.
         # Corresponds to the JSON property `sponsorSince`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :sponsor_since
       
         def initialize(**args)
@@ -6746,10 +6727,11 @@ module Google
         end
       end
       
-      # A subscription resource contains information about a YouTube user subscription.
-      # A subscription notifies a user when new videos are added to a channel or when
-      # another user takes one of several actions on YouTube, such as uploading a
-      # video, rating a video, or commenting on a video.
+      # A <code><strong>subscription</strong></code> resource contains information
+      # about a YouTube user subscription.  A subscription notifies a user when new
+      # videos are added to a channel or when another user takes one of several
+      # actions on YouTube, such as uploading a video, rating a video, or commenting
+      # on a video.
       class Subscription
         include Google::Apis::Core::Hashable
       
@@ -6768,8 +6750,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # subscription".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#subscription"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -6780,8 +6762,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::SubscriptionSnippet]
         attr_accessor :snippet
       
-        # Basic details about a subscription's subscriber including title, description,
-        # channel ID and thumbnails.
+        # Basic details about a subscription's subscriber including title,
+        # description, channel ID and thumbnails.
         # Corresponds to the JSON property `subscriberSnippet`
         # @return [Google::Apis::YoutubeV3::SubscriptionSubscriberSnippet]
         attr_accessor :subscriber_snippet
@@ -6805,12 +6787,14 @@ module Google
       class SubscriptionContentDetails
         include Google::Apis::Core::Hashable
       
-        # The type of activity this subscription is for (only uploads, everything).
+        # The type of activity this subscription is for
+        # (only uploads, everything).
         # Corresponds to the JSON property `activityType`
         # @return [String]
         attr_accessor :activity_type
       
-        # The number of new items in the subscription since its content was last read.
+        # The number of new items in the subscription since its content was last
+        # read.
         # Corresponds to the JSON property `newItemCount`
         # @return [Fixnum]
         attr_accessor :new_item_count
@@ -6851,14 +6835,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::Subscription>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # subscriptionListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#subscriptionListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -6869,8 +6853,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -6880,7 +6864,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -6923,10 +6907,11 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # The date and time that the subscription was created. The value is specified in
-        # ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the subscription was created. The value is
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # A resource id is a generic reference that points to another YouTube resource.
@@ -6960,8 +6945,8 @@ module Google
         end
       end
       
-      # Basic details about a subscription's subscriber including title, description,
-      # channel ID and thumbnails.
+      # Basic details about a subscription's subscriber including title,
+      # description, channel ID and thumbnails.
       class SubscriptionSubscriberSnippet
         include Google::Apis::Core::Hashable
       
@@ -6998,7 +6983,7 @@ module Google
         end
       end
       
-      # A superChatEvent resource represents a Super Chat purchase on a YouTube
+      # A `__superChatEvent__` resource represents a Super Chat purchase on a YouTube
       # channel.
       class SuperChatEvent
         include Google::Apis::Core::Hashable
@@ -7013,13 +6998,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # superChatEvent".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#superChatEvent"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The snippet object contains basic details about the Super Chat event.
+        # The `snippet` object contains basic details about the Super Chat event.
         # Corresponds to the JSON property `snippet`
         # @return [Google::Apis::YoutubeV3::SuperChatEventSnippet]
         attr_accessor :snippet
@@ -7056,14 +7041,14 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::SuperChatEvent>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # superChatEventListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#superChatEventListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -7079,7 +7064,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -7105,7 +7090,7 @@ module Google
       class SuperChatEventSnippet
         include Google::Apis::Core::Hashable
       
-        # The purchase amount, in micros of the purchase currency. e.g., 1 is
+        # The purchase amount, in micros of the purchase currency.  e.g., 1 is
         # represented as 1000000.
         # Corresponds to the JSON property `amountMicros`
         # @return [Fixnum]
@@ -7121,48 +7106,38 @@ module Google
         # @return [String]
         attr_accessor :comment_text
       
-        # The date and time when the event occurred. The value is specified in ISO 8601 (
-        # YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time when the event occurred. The value is
+        # specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `createdAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :created_at
       
-        # The currency in which the purchase was made. ISO 4217.
+        # The currency in which the purchase was made.  ISO 4217.
         # Corresponds to the JSON property `currency`
         # @return [String]
         attr_accessor :currency
       
-        # A rendered string that displays the purchase amount and currency (e.g., "$1.00"
-        # ). The string is rendered for the given language.
+        # A rendered string that displays the purchase amount and currency
+        # (e.g., "$1.00").  The string is rendered for the given language.
         # Corresponds to the JSON property `displayString`
         # @return [String]
         attr_accessor :display_string
       
-        # True if this event is a Super Chat for Good purchase.
-        # Corresponds to the JSON property `isSuperChatForGood`
-        # @return [Boolean]
-        attr_accessor :is_super_chat_for_good
-        alias_method :is_super_chat_for_good?, :is_super_chat_for_good
-      
         # True if this event is a Super Sticker event.
         # Corresponds to the JSON property `isSuperStickerEvent`
         # @return [Boolean]
         attr_accessor :is_super_sticker_event
         alias_method :is_super_sticker_event?, :is_super_sticker_event
       
-        # The tier for the paid message, which is based on the amount of money spent to
-        # purchase the message.
+        # The tier for the paid message, which is based on the amount of money spent
+        # to purchase the message.
         # Corresponds to the JSON property `messageType`
         # @return [Fixnum]
         attr_accessor :message_type
       
-        # Nonprofit information.
-        # Corresponds to the JSON property `nonprofit`
-        # @return [Google::Apis::YoutubeV3::Nonprofit]
-        attr_accessor :nonprofit
-      
-        # If this event is a Super Sticker event, this field will contain metadata about
-        # the Super Sticker.
+        # If this event is a Super Sticker event, this field will contain metadata
+        # about the Super Sticker.
         # Corresponds to the JSON property `superStickerMetadata`
         # @return [Google::Apis::YoutubeV3::SuperStickerMetadata]
         attr_accessor :super_sticker_metadata
@@ -7184,10 +7159,8 @@ module Google
           @created_at = args[:created_at] if args.key?(:created_at)
           @currency = args[:currency] if args.key?(:currency)
           @display_string = args[:display_string] if args.key?(:display_string)
-          @is_super_chat_for_good = args[:is_super_chat_for_good] if args.key?(:is_super_chat_for_good)
           @is_super_sticker_event = args[:is_super_sticker_event] if args.key?(:is_super_sticker_event)
           @message_type = args[:message_type] if args.key?(:message_type)
-          @nonprofit = args[:nonprofit] if args.key?(:nonprofit)
           @super_sticker_metadata = args[:super_sticker_metadata] if args.key?(:super_sticker_metadata)
           @supporter_details = args[:supporter_details] if args.key?(:supporter_details)
         end
@@ -7197,8 +7170,8 @@ module Google
       class SuperStickerMetadata
         include Google::Apis::Core::Hashable
       
-        # Internationalized alt text that describes the sticker image and any animation
-        # associated with it.
+        # Internationalized alt text that describes the sticker image and any
+        # animation associated with it.
         # Corresponds to the JSON property `altText`
         # @return [String]
         attr_accessor :alt_text
@@ -7208,8 +7181,9 @@ module Google
         # @return [String]
         attr_accessor :alt_text_language
       
-        # Unique identifier of the Super Sticker. This is a shorter form of the alt_text
-        # that includes pack name and a recognizable characteristic of the sticker.
+        # Unique identifier of the Super Sticker. This is a shorter form of the
+        # alt_text that includes pack name and a recognizable characteristic of the
+        # sticker.
         # Corresponds to the JSON property `stickerId`
         # @return [String]
         attr_accessor :sticker_id
@@ -7319,13 +7293,13 @@ module Google
         # @return [Array<Google::Apis::YoutubeV3::ThumbnailDetails>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # thumbnailSetResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#thumbnailSetResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -7357,12 +7331,12 @@ module Google
         end
       end
       
-      # A video resource represents a YouTube video.
+      # A <code><strong>video</strong></code> resource represents a YouTube video.
       class Video
         include Google::Apis::Core::Hashable
       
-        # Age restriction details related to a video. This data can only be retrieved by
-        # the video owner.
+        # Age restriction details related to a video. This data can only be retrieved
+        # by the video owner.
         # Corresponds to the JSON property `ageGating`
         # @return [Google::Apis::YoutubeV3::VideoAgeGating]
         attr_accessor :age_gating
@@ -7389,8 +7363,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # video".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#video"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7400,7 +7374,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::VideoLiveStreamingDetails]
         attr_accessor :live_streaming_details
       
-        # List with all localizations.
+        # The <code>localizations</code> object contains localized versions of the
+        # basic details about the video, such as its title and description.
         # Corresponds to the JSON property `localizations`
         # @return [Hash<String,Google::Apis::YoutubeV3::VideoLocalization>]
         attr_accessor :localizations
@@ -7444,12 +7419,13 @@ module Google
         attr_accessor :statistics
       
         # Basic details about a video category, such as its localized title.
+        # Next Id: 16
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::YoutubeV3::VideoStatus]
         attr_accessor :status
       
-        # Specifies suggestions on how to improve video content, including encoding
-        # hints, tag suggestions, and editor suggestions.
+        # Specifies suggestions on how to improve video content,
+        # including encoding hints, tag suggestions, and editor suggestions.
         # Corresponds to the JSON property `suggestions`
         # @return [Google::Apis::YoutubeV3::VideoSuggestions]
         attr_accessor :suggestions
@@ -7500,15 +7476,15 @@ module Google
         # @return [String]
         attr_accessor :language
       
-        # The high-level, or primary, reason that the content is abusive. The value is
-        # an abuse report reason ID.
+        # The high-level, or primary, reason that the content is abusive. The value
+        # is an abuse report reason ID.
         # Corresponds to the JSON property `reasonId`
         # @return [String]
         attr_accessor :reason_id
       
-        # The specific, or secondary, reason that this content is abusive (if available).
-        # The value is an abuse report reason ID that is a valid secondary reason for
-        # the primary reason.
+        # The specific, or secondary, reason that this content is abusive (if
+        # available). The value is an abuse report reason ID that is a valid
+        # secondary reason for the primary reason.
         # Corresponds to the JSON property `secondaryReasonId`
         # @return [String]
         attr_accessor :secondary_reason_id
@@ -7532,9 +7508,9 @@ module Google
         end
       end
       
-      # A videoAbuseReportReason resource identifies a reason that a video could be
-      # reported as abusive. Video abuse report reasons are used with video.
-      # ReportAbuse.
+      # A `__videoAbuseReportReason__` resource identifies a reason that a video
+      # could be reported as abusive. Video abuse report reasons are used with
+      # `video.ReportAbuse`.
       class VideoAbuseReportReason
         include Google::Apis::Core::Hashable
       
@@ -7548,8 +7524,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoAbuseReportReason".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#videoAbuseReportReason"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7586,18 +7562,18 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of valid abuse reasons that are used with video.ReportAbuse.
+        # A list of valid abuse reasons that are used with `video.ReportAbuse`.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::VideoAbuseReportReason>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoAbuseReportReasonListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # `"youtube#videoAbuseReportReasonListResponse"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The visitorId identifies the visitor.
+        # The `visitorId` identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -7625,8 +7601,8 @@ module Google
         # @return [String]
         attr_accessor :label
       
-        # The secondary reasons associated with this reason, if any are available. (
-        # There might be 0 or more.)
+        # The secondary reasons associated with this reason, if any are available.
+        # (There might be 0 or more.)
         # Corresponds to the JSON property `secondaryReasons`
         # @return [Array<Google::Apis::YoutubeV3::VideoAbuseReportSecondaryReason>]
         attr_accessor :secondary_reasons
@@ -7671,17 +7647,18 @@ module Google
       class VideoAgeGating
         include Google::Apis::Core::Hashable
       
-        # Indicates whether or not the video has alcoholic beverage content. Only users
-        # of legal purchasing age in a particular country, as identified by ICAP, can
-        # view the content.
+        # Indicates whether or not the video has alcoholic beverage content. Only
+        # users of legal purchasing age in a particular country, as identified by
+        # ICAP, can view the content.
         # Corresponds to the JSON property `alcoholContent`
         # @return [Boolean]
         attr_accessor :alcohol_content
         alias_method :alcohol_content?, :alcohol_content
       
         # Age-restricted trailers. For redband trailers and adult-rated video-games.
-        # Only users aged 18+ can view the content. The the field is true the content is
-        # restricted to viewers aged 18+. Otherwise The field won't be present.
+        # Only users aged 18+ can view the content. The the field is
+        # <code>true</code> the content is restricted to viewers aged 18+. Otherwise
+        # The field won't be present.
         # Corresponds to the JSON property `restricted`
         # @return [Boolean]
         attr_accessor :restricted
@@ -7704,8 +7681,8 @@ module Google
         end
       end
       
-      # A videoCategory resource identifies a category that has been or could be
-      # associated with uploaded videos.
+      # A <code><strong>videoCategory</strong></code> resource identifies a
+      # category that has been or could be associated with uploaded videos.
       class VideoCategory
         include Google::Apis::Core::Hashable
       
@@ -7719,8 +7696,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoCategory".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#videoCategory"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7757,21 +7734,21 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of video categories that can be associated with YouTube videos. In this
-        # map, the video category ID is the map key, and its value is the corresponding
-        # videoCategory resource.
+        # A list of video categories that can be associated with YouTube videos. In
+        # this map, the video category ID is the map key, and its value is the
+        # corresponding <code>videoCategory</code> resource.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::VideoCategory>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoCategoryListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#videoCategoryListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -7782,8 +7759,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -7793,7 +7770,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -7852,13 +7829,15 @@ module Google
       class VideoContentDetails
         include Google::Apis::Core::Hashable
       
-        # The value of captions indicates whether the video has captions or not.
+        # The value of <code>captions</code> indicates whether the video
+        # has captions or not.
         # Corresponds to the JSON property `caption`
         # @return [String]
         attr_accessor :caption
       
-        # Ratings schemes. The country-specific ratings are mostly for movies and shows.
-        # NEXT_ID: 72
+        # Ratings schemes. The country-specific ratings are mostly for
+        # movies and shows.
+        # LINT.IfChange
         # Corresponds to the JSON property `contentRating`
         # @return [Google::Apis::YoutubeV3::ContentRating]
         attr_accessor :content_rating
@@ -7868,36 +7847,42 @@ module Google
         # @return [Google::Apis::YoutubeV3::AccessPolicy]
         attr_accessor :country_restriction
       
-        # The value of definition indicates whether the video is available in high
-        # definition or only in standard definition.
+        # The value of <code>definition</code> indicates whether the video is
+        # available in high definition or only in standard definition.
         # Corresponds to the JSON property `definition`
         # @return [String]
         attr_accessor :definition
       
-        # The value of dimension indicates whether the video is available in 3D or in 2D.
+        # The value of <code>dimension</code> indicates whether the video is
+        # available in 3D or in 2D.
         # Corresponds to the JSON property `dimension`
         # @return [String]
         attr_accessor :dimension
       
-        # The length of the video. The tag value is an ISO 8601 duration in the format
-        # PT#M#S, in which the letters PT indicate that the value specifies a period of
-        # time, and the letters M and S refer to length in minutes and seconds,
-        # respectively. The # characters preceding the M and S letters are both integers
-        # that specify the number of minutes (or seconds) of the video. For example, a
-        # value of PT15M51S indicates that the video is 15 minutes and 51 seconds long.
+        # The length of the video. The tag value is an <a
+        # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in
+        # the format <code>PT#M#S</code>, in which the letters <code>PT</code>
+        # indicate that the value specifies a period of time, and the letters
+        # <code>M</code> and <code>S</code> refer to length in minutes and seconds,
+        # respectively. The <code>#</code> characters preceding the <code>M</code>
+        # and <code>S</code> letters are both integers that specify the number of
+        # minutes (or seconds) of the video. For example, a value of
+        # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds
+        # long.
         # Corresponds to the JSON property `duration`
         # @return [String]
         attr_accessor :duration
       
-        # Indicates whether the video uploader has provided a custom thumbnail image for
-        # the video. This property is only visible to the video uploader.
+        # Indicates whether the video uploader has provided a custom
+        # thumbnail image for the video.
+        # This property is only visible to the video uploader.
         # Corresponds to the JSON property `hasCustomThumbnail`
         # @return [Boolean]
         attr_accessor :has_custom_thumbnail
         alias_method :has_custom_thumbnail?, :has_custom_thumbnail
       
-        # The value of is_license_content indicates whether the video is licensed
-        # content.
+        # The value of <code>is_license_content</code> indicates whether the video is
+        # licensed content.
         # Corresponds to the JSON property `licensedContent`
         # @return [Boolean]
         attr_accessor :licensed_content
@@ -7936,18 +7921,20 @@ module Google
       class VideoContentDetailsRegionRestriction
         include Google::Apis::Core::Hashable
       
-        # A list of region codes that identify countries where the video is viewable. If
-        # this property is present and a country is not listed in its value, then the
-        # video is blocked from appearing in that country. If this property is present
-        # and contains an empty list, the video is blocked in all countries.
+        # A list of region codes that identify countries where the video is
+        # viewable. If this property is present and a country is not listed
+        # in its value, then the video is blocked from appearing in that
+        # country. If this property is present and contains an empty list,
+        # the video is blocked in all countries.
         # Corresponds to the JSON property `allowed`
         # @return [Array<String>]
         attr_accessor :allowed
       
-        # A list of region codes that identify countries where the video is blocked. If
-        # this property is present and a country is not listed in its value, then the
-        # video is viewable in that country. If this property is present and contains an
-        # empty list, the video is viewable in all countries.
+        # A list of region codes that identify countries where the video is
+        # blocked. If this property is present and a country is not listed in
+        # its value, then the video is viewable in that country. If this
+        # property is present and contains an empty list, the video is
+        # viewable in all countries.
         # Corresponds to the JSON property `blocked`
         # @return [Array<String>]
         attr_accessor :blocked
@@ -7969,14 +7956,14 @@ module Google
       class VideoFileDetails
         include Google::Apis::Core::Hashable
       
-        # A list of audio streams contained in the uploaded video file. Each item in the
-        # list contains detailed metadata about an audio stream.
+        # A list of audio streams contained in the uploaded video file. Each item
+        # in the list contains detailed metadata about an audio stream.
         # Corresponds to the JSON property `audioStreams`
         # @return [Array<Google::Apis::YoutubeV3::VideoFileDetailsAudioStream>]
         attr_accessor :audio_streams
       
-        # The uploaded video file's combined (video and audio) bitrate in bits per
-        # second.
+        # The uploaded video file's combined (video and audio) bitrate in bits
+        # per second.
         # Corresponds to the JSON property `bitrateBps`
         # @return [Fixnum]
         attr_accessor :bitrate_bps
@@ -7987,11 +7974,13 @@ module Google
         attr_accessor :container
       
         # The date and time when the uploaded video file was created. The value is
-        # specified in ISO 8601 format. Currently, the following ISO 8601 formats are
-        # supported:
-        # - Date only: YYYY-MM-DD
-        # - Naive time: YYYY-MM-DDTHH:MM:SS
-        # - Time with timezone: YYYY-MM-DDTHH:MM:SS+HH:MM
+        # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # format. Currently, the following ISO 8601 formats are supported:
+        # <ul>
+        # <li>Date only: <code>YYYY-MM-DD</code></li>
+        # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li>
+        # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li>
+        # </ul>
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
@@ -8007,21 +7996,21 @@ module Google
         # @return [String]
         attr_accessor :file_name
       
-        # The uploaded file's size in bytes. This field is present whether a video file
-        # or another type of file was uploaded.
+        # The uploaded file's size in bytes. This field is present whether
+        # a video file or another type of file was uploaded.
         # Corresponds to the JSON property `fileSize`
         # @return [Fixnum]
         attr_accessor :file_size
       
-        # The uploaded file's type as detected by YouTube's video processing engine.
-        # Currently, YouTube only processes video files, but this field is present
-        # whether a video file or another type of file was uploaded.
+        # The uploaded file's type as detected by YouTube's video processing
+        # engine. Currently, YouTube only processes video files, but this field
+        # is present whether a video file or another type of file was uploaded.
         # Corresponds to the JSON property `fileType`
         # @return [String]
         attr_accessor :file_type
       
-        # A list of video streams contained in the uploaded video file. Each item in the
-        # list contains detailed metadata about a video stream.
+        # A list of video streams contained in the uploaded video file. Each item
+        # in the list contains detailed metadata about a video stream.
         # Corresponds to the JSON property `videoStreams`
         # @return [Array<Google::Apis::YoutubeV3::VideoFileDetailsVideoStream>]
         attr_accessor :video_streams
@@ -8063,8 +8052,8 @@ module Google
         # @return [String]
         attr_accessor :codec
       
-        # A value that uniquely identifies a video vendor. Typically, the value is a
-        # four-letter vendor code.
+        # A value that uniquely identifies a video vendor. Typically, the value
+        # is a four-letter vendor code.
         # Corresponds to the JSON property `vendor`
         # @return [String]
         attr_accessor :vendor
@@ -8086,8 +8075,8 @@ module Google
       class VideoFileDetailsVideoStream
         include Google::Apis::Core::Hashable
       
-        # The video content's display aspect ratio, which specifies the aspect ratio in
-        # which the video should be displayed.
+        # The video content's display aspect ratio, which specifies the aspect
+        # ratio in which the video should be displayed.
         # Corresponds to the JSON property `aspectRatio`
         # @return [Float]
         attr_accessor :aspect_ratio
@@ -8112,20 +8101,21 @@ module Google
         # @return [Fixnum]
         attr_accessor :height_pixels
       
-        # The amount that YouTube needs to rotate the original source content to
-        # properly display the video.
+        # The amount that YouTube needs to rotate the original source content
+        # to properly display the video.
         # Corresponds to the JSON property `rotation`
         # @return [String]
         attr_accessor :rotation
       
-        # A value that uniquely identifies a video vendor. Typically, the value is a
-        # four-letter vendor code.
+        # A value that uniquely identifies a video vendor. Typically, the value is
+        # a four-letter vendor code.
         # Corresponds to the JSON property `vendor`
         # @return [String]
         attr_accessor :vendor
       
-        # The encoded video content's width in pixels. You can calculate the video's
-        # encoding aspect ratio as width_pixels / height_pixels.
+        # The encoded video content's width in pixels. You can calculate the
+        # video's encoding aspect ratio as
+        # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>.
         # Corresponds to the JSON property `widthPixels`
         # @return [Fixnum]
         attr_accessor :width_pixels
@@ -8147,50 +8137,6 @@ module Google
         end
       end
       
-      # 
-      class GetVideoRatingResponse
-        include Google::Apis::Core::Hashable
-      
-        # Etag of this resource.
-        # Corresponds to the JSON property `etag`
-        # @return [String]
-        attr_accessor :etag
-      
-        # Serialized EventId of the request which produced this response.
-        # Corresponds to the JSON property `eventId`
-        # @return [String]
-        attr_accessor :event_id
-      
-        # A list of ratings that match the request criteria.
-        # Corresponds to the JSON property `items`
-        # @return [Array<Google::Apis::YoutubeV3::VideoRating>]
-        attr_accessor :items
-      
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoGetRatingResponse".
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        # The visitorId identifies the visitor.
-        # Corresponds to the JSON property `visitorId`
-        # @return [String]
-        attr_accessor :visitor_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @etag = args[:etag] if args.key?(:etag)
-          @event_id = args[:event_id] if args.key?(:event_id)
-          @items = args[:items] if args.key?(:items)
-          @kind = args[:kind] if args.key?(:kind)
-          @visitor_id = args[:visitor_id] if args.key?(:visitor_id)
-        end
-      end
-      
       # 
       class ListVideosResponse
         include Google::Apis::Core::Hashable
@@ -8205,19 +8151,19 @@ module Google
         # @return [String]
         attr_accessor :event_id
       
-        # A list of videos that match the request criteria.
+        # 
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::YoutubeV3::Video>]
         attr_accessor :items
       
-        # Identifies what kind of resource this is. Value: the fixed string "youtube#
-        # videoListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#videoListResponse"</code>.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the next page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the next page in the result set.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -8228,8 +8174,8 @@ module Google
         # @return [Google::Apis::YoutubeV3::PageInfo]
         attr_accessor :page_info
       
-        # The token that can be used as the value of the pageToken parameter to retrieve
-        # the previous page in the result set.
+        # The token that can be used as the value of the <code>pageToken</code>
+        # parameter to retrieve the previous page in the result set.
         # Corresponds to the JSON property `prevPageToken`
         # @return [String]
         attr_accessor :prev_page_token
@@ -8239,7 +8185,7 @@ module Google
         # @return [Google::Apis::YoutubeV3::TokenPagination]
         attr_accessor :token_pagination
       
-        # The visitorId identifies the visitor.
+        # The <code>visitorId</code> identifies the visitor.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -8266,51 +8212,57 @@ module Google
       class VideoLiveStreamingDetails
         include Google::Apis::Core::Hashable
       
-        # The ID of the currently active live chat attached to this video. This field is
-        # filled only if the video is a currently live broadcast that has live chat.
-        # Once the broadcast transitions to complete this field will be removed and the
-        # live chat closed down. For persistent broadcasts that live chat id will no
-        # longer be tied to this video but rather to the new video being displayed at
-        # the persistent page.
+        # The ID of the currently active live chat attached to this video. This
+        # field is filled only if the video is a currently live broadcast that has
+        # live chat. Once the broadcast transitions to complete this field will be
+        # removed and the live chat closed down. For persistent broadcasts that live
+        # chat id will no longer be tied to this video but rather to the new video
+        # being displayed at the persistent page.
         # Corresponds to the JSON property `activeLiveChatId`
         # @return [String]
         attr_accessor :active_live_chat_id
       
-        # The time that the broadcast actually ended. The value is specified in ISO 8601
-        # (YYYY-MM-DDThh:mm:ss.sZ) format. This value will not be available until the
-        # broadcast is over.
+        # The time that the broadcast actually ended. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format. This value will not be
+        # available until the broadcast is over.
         # Corresponds to the JSON property `actualEndTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :actual_end_time
       
-        # The time that the broadcast actually started. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format. This value will not be available until
-        # the broadcast begins.
+        # The time that the broadcast actually started. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format. This value will not be
+        # available until the broadcast begins.
         # Corresponds to the JSON property `actualStartTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :actual_start_time
       
-        # The number of viewers currently watching the broadcast. The property and its
-        # value will be present if the broadcast has current viewers and the broadcast
-        # owner has not hidden the viewcount for the video. Note that YouTube stops
-        # tracking the number of concurrent viewers for a broadcast when the broadcast
-        # ends. So, this property would not identify the number of viewers watching an
-        # archived video of a live broadcast that already ended.
+        # The number of viewers currently watching the broadcast. The property and
+        # its value will be present if the broadcast has current viewers and the
+        # broadcast owner has not hidden the viewcount for the video. Note that
+        # YouTube stops tracking the number of concurrent viewers for a broadcast
+        # when the broadcast ends. So, this property would not identify the number
+        # of viewers watching an archived video of a live broadcast that already
+        # ended.
         # Corresponds to the JSON property `concurrentViewers`
         # @return [Fixnum]
         attr_accessor :concurrent_viewers
       
-        # The time that the broadcast is scheduled to end. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format. If the value is empty or the property is
-        # not present, then the broadcast is scheduled to continue indefinitely.
+        # The time that the broadcast is scheduled to end. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format. If the value is empty or
+        # the property is not present, then the broadcast is scheduled to continue
+        # indefinitely.
         # Corresponds to the JSON property `scheduledEndTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :scheduled_end_time
       
-        # The time that the broadcast is scheduled to begin. The value is specified in
-        # ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The time that the broadcast is scheduled to begin. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `scheduledStartTime`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :scheduled_start_time
       
         def initialize(**args)
@@ -8381,7 +8333,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :embed_height
       
-        # An <iframe> tag that embeds a player that will play the video.
+        # An <code>&lt;iframe&gt;</code> tag that embeds a player that will
+        # play the video.
         # Corresponds to the JSON property `embedHtml`
         # @return [String]
         attr_accessor :embed_html
@@ -8408,32 +8361,34 @@ module Google
       class VideoProcessingDetails
         include Google::Apis::Core::Hashable
       
-        # This value indicates whether video editing suggestions, which might improve
-        # video quality or the playback experience, are available for the video. You can
-        # retrieve these suggestions by requesting the suggestions part in your videos.
-        # list() request.
+        # This value indicates whether video editing suggestions, which might
+        # improve video quality or the playback experience, are available for
+        # the video. You can retrieve these suggestions by requesting the
+        # <code>suggestions</code> part in your <code>videos.list()</code> request.
         # Corresponds to the JSON property `editorSuggestionsAvailability`
         # @return [String]
         attr_accessor :editor_suggestions_availability
       
-        # This value indicates whether file details are available for the uploaded video.
-        # You can retrieve a video's file details by requesting the fileDetails part in
-        # your videos.list() request.
+        # This value indicates whether file details are available for the uploaded
+        # video. You can retrieve a video's file details by requesting the
+        # <code>fileDetails</code> part in your <code>videos.list()</code> request.
         # Corresponds to the JSON property `fileDetailsAvailability`
         # @return [String]
         attr_accessor :file_details_availability
       
-        # The reason that YouTube failed to process the video. This property will only
-        # have a value if the processingStatus property's value is failed.
+        # The reason that YouTube failed to process the video. This property will
+        # only have a value if the <code>processingStatus</code>
+        # property's value is <code>failed</code>.
         # Corresponds to the JSON property `processingFailureReason`
         # @return [String]
         attr_accessor :processing_failure_reason
       
         # This value indicates whether the video processing engine has generated
-        # suggestions that might improve YouTube's ability to process the the video,
-        # warnings that explain video processing problems, or errors that cause video
-        # processing problems. You can retrieve these suggestions by requesting the
-        # suggestions part in your videos.list() request.
+        # suggestions that might improve YouTube's ability to process the
+        # the video, warnings that explain video processing problems, or
+        # errors that cause video processing problems. You can retrieve these
+        # suggestions by requesting the <code>suggestions</code> part in your
+        # <code>videos.list()</code> request.
         # Corresponds to the JSON property `processingIssuesAvailability`
         # @return [String]
         attr_accessor :processing_issues_availability
@@ -8443,22 +8398,23 @@ module Google
         # @return [Google::Apis::YoutubeV3::VideoProcessingDetailsProcessingProgress]
         attr_accessor :processing_progress
       
-        # The video's processing status. This value indicates whether YouTube was able
-        # to process the video or if the video is still being processed.
+        # The video's processing status. This value indicates whether YouTube was
+        # able to process the video or if the video is still being processed.
         # Corresponds to the JSON property `processingStatus`
         # @return [String]
         attr_accessor :processing_status
       
-        # This value indicates whether keyword (tag) suggestions are available for the
-        # video. Tags can be added to a video's metadata to make it easier for other
-        # users to find the video. You can retrieve these suggestions by requesting the
-        # suggestions part in your videos.list() request.
+        # This value indicates whether keyword (tag) suggestions are available for
+        # the video. Tags can be added to a video's metadata to make it easier for
+        # other users to find the video. You can retrieve these suggestions by
+        # requesting the <code>suggestions</code> part in your
+        # <code>videos.list()</code> request.
         # Corresponds to the JSON property `tagSuggestionsAvailability`
         # @return [String]
         attr_accessor :tag_suggestions_availability
       
-        # This value indicates whether thumbnail images have been generated for the
-        # video.
+        # This value indicates whether thumbnail images have been generated for
+        # the video.
         # Corresponds to the JSON property `thumbnailsAvailability`
         # @return [String]
         attr_accessor :thumbnails_availability
@@ -8484,27 +8440,27 @@ module Google
       class VideoProcessingDetailsProcessingProgress
         include Google::Apis::Core::Hashable
       
-        # The number of parts of the video that YouTube has already processed. You can
-        # estimate the percentage of the video that YouTube has already processed by
-        # calculating:
-        # 100 * parts_processed / parts_total
-        # Note that since the estimated number of parts could increase without a
-        # corresponding increase in the number of parts that have already been processed,
-        # it is possible that the calculated progress could periodically decrease while
-        # YouTube processes a video.
+        # The number of parts of the video that YouTube has already processed.
+        # You can estimate the percentage of the video that YouTube has already
+        # processed by calculating:<br>
+        # <code>100 * parts_processed / parts_total</code><br><br>
+        # Note that since the estimated number of parts could increase without
+        # a corresponding increase in the number of parts that have already been
+        # processed, it is possible that the calculated progress could
+        # periodically decrease while YouTube processes a video.
         # Corresponds to the JSON property `partsProcessed`
         # @return [Fixnum]
         attr_accessor :parts_processed
       
-        # An estimate of the total number of parts that need to be processed for the
-        # video. The number may be updated with more precise estimates while YouTube
-        # processes the video.
+        # An estimate of the total number of parts that need to be processed
+        # for the video. The number may be updated with more precise estimates
+        # while YouTube processes the video.
         # Corresponds to the JSON property `partsTotal`
         # @return [Fixnum]
         attr_accessor :parts_total
       
-        # An estimate of the amount of time, in millseconds, that YouTube needs to
-        # finish processing the video.
+        # An estimate of the amount of time, in millseconds, that YouTube needs
+        # to finish processing the video.
         # Corresponds to the JSON property `timeLeftMs`
         # @return [Fixnum]
         attr_accessor :time_left_ms
@@ -8540,16 +8496,16 @@ module Google
         end
       end
       
-      # 
+      # Basic details about rating of a video.
       class VideoRating
         include Google::Apis::Core::Hashable
       
-        # 
+        # Rating of a video.
         # Corresponds to the JSON property `rating`
         # @return [String]
         attr_accessor :rating
       
-        # 
+        # The ID that YouTube uses to uniquely identify the video.
         # Corresponds to the JSON property `videoId`
         # @return [String]
         attr_accessor :video_id
@@ -8565,6 +8521,50 @@ module Google
         end
       end
       
+      # 
+      class VideoRatingListResponse
+        include Google::Apis::Core::Hashable
+      
+        # Etag of this resource.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Serialized EventId of the request which produced this response.
+        # Corresponds to the JSON property `eventId`
+        # @return [String]
+        attr_accessor :event_id
+      
+        # A list of ratings that match the request criteria.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::YoutubeV3::VideoRating>]
+        attr_accessor :items
+      
+        # Identifies what kind of resource this is. Value: the fixed string
+        # <code>"youtube#videoGetRatingResponse"</code>.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The <code>visitorId</code> identifies the visitor.
+        # Corresponds to the JSON property `visitorId`
+        # @return [String]
+        attr_accessor :visitor_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @event_id = args[:event_id] if args.key?(:event_id)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @visitor_id = args[:visitor_id] if args.key?(:visitor_id)
+        end
+      end
+      
       # Recording information associated with the video.
       class VideoRecordingDetails
         include Google::Apis::Core::Hashable
@@ -8579,10 +8579,11 @@ module Google
         # @return [String]
         attr_accessor :location_description
       
-        # The date and time when the video was recorded. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sssZ) format.
+        # The date and time when the video was recorded. The value is specified in <a
+        # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format.
         # Corresponds to the JSON property `recordingDate`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :recording_date
       
         def initialize(**args)
@@ -8602,13 +8603,14 @@ module Google
       class VideoSnippet
         include Google::Apis::Core::Hashable
       
-        # The YouTube video category associated with the video.
+        # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video
+        # category</a> associated with the video.
         # Corresponds to the JSON property `categoryId`
         # @return [String]
         attr_accessor :category_id
       
-        # The ID that YouTube uses to uniquely identify the channel that the video was
-        # uploaded to.
+        # The ID that YouTube uses to uniquely identify the channel that the
+        # video was uploaded to.
         # Corresponds to the JSON property `channelId`
         # @return [String]
         attr_accessor :channel_id
@@ -8618,8 +8620,8 @@ module Google
         # @return [String]
         attr_accessor :channel_title
       
-        # The default_audio_language property specifies the language spoken in the video'
-        # s default audio track.
+        # The <code>default_audio_language</code> property specifies the language
+        # spoken in the video's default audio track.
         # Corresponds to the JSON property `defaultAudioLanguage`
         # @return [String]
         attr_accessor :default_audio_language
@@ -8630,12 +8632,13 @@ module Google
         attr_accessor :default_language
       
         # The video's description.
+        # @mutable youtube.videos.insert youtube.videos.update
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Indicates if the video is an upcoming/active live broadcast. Or it's "none" if
-        # the video is not an upcoming/active live broadcast.
+        # Indicates if the video is an upcoming/active live broadcast.
+        # Or it's "none" if the video is not an upcoming/active live broadcast.
         # Corresponds to the JSON property `liveBroadcastContent`
         # @return [String]
         attr_accessor :live_broadcast_content
@@ -8645,10 +8648,11 @@ module Google
         # @return [Google::Apis::YoutubeV3::VideoLocalization]
         attr_accessor :localized
       
-        # The date and time that the video was uploaded. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time that the video was uploaded. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishedAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :published_at
       
         # A list of keyword tags associated with the video. Tags may contain spaces.
@@ -8662,6 +8666,7 @@ module Google
         attr_accessor :thumbnails
       
         # The video's title.
+        # @mutable youtube.videos.insert youtube.videos.update
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -8697,19 +8702,20 @@ module Google
         # @return [Fixnum]
         attr_accessor :comment_count
       
-        # The number of users who have indicated that they disliked the video by giving
-        # it a negative rating.
+        # The number of users who have indicated that they disliked the video by
+        # giving it a negative rating.
         # Corresponds to the JSON property `dislikeCount`
         # @return [Fixnum]
         attr_accessor :dislike_count
       
-        # The number of users who currently have the video marked as a favorite video.
+        # The number of users who currently have the video marked as a favorite
+        # video.
         # Corresponds to the JSON property `favoriteCount`
         # @return [Fixnum]
         attr_accessor :favorite_count
       
-        # The number of users who have indicated that they liked the video by giving it
-        # a positive rating.
+        # The number of users who have indicated that they liked the video by
+        # giving it a positive rating.
         # Corresponds to the JSON property `likeCount`
         # @return [Fixnum]
         attr_accessor :like_count
@@ -8734,22 +8740,26 @@ module Google
       end
       
       # Basic details about a video category, such as its localized title.
+      # Next Id: 16
       class VideoStatus
         include Google::Apis::Core::Hashable
       
         # This value indicates if the video can be embedded on another website.
+        # @mutable youtube.videos.insert youtube.videos.update
         # Corresponds to the JSON property `embeddable`
         # @return [Boolean]
         attr_accessor :embeddable
         alias_method :embeddable?, :embeddable
       
-        # This value explains why a video failed to upload. This property is only
-        # present if the uploadStatus property indicates that the upload failed.
+        # This value explains why a video failed to upload. This property is
+        # only present if the <code>uploadStatus</code> property indicates that
+        # the upload failed.
         # Corresponds to the JSON property `failureReason`
         # @return [String]
         attr_accessor :failure_reason
       
         # The video's license.
+        # @mutable youtube.videos.insert youtube.videos.update
         # Corresponds to the JSON property `license`
         # @return [String]
         attr_accessor :license
@@ -8765,24 +8775,26 @@ module Google
         # @return [String]
         attr_accessor :privacy_status
       
-        # This value indicates if the extended video statistics on the watch page can be
-        # viewed by everyone. Note that the view count, likes, etc will still be visible
-        # if this is disabled.
+        # This value indicates if the extended video statistics on the watch page
+        # can be viewed by everyone. Note that the view count, likes, etc will still
+        # be visible if this is disabled.
+        # @mutable youtube.videos.insert youtube.videos.update
         # Corresponds to the JSON property `publicStatsViewable`
         # @return [Boolean]
         attr_accessor :public_stats_viewable
         alias_method :public_stats_viewable?, :public_stats_viewable
       
-        # The date and time when the video is scheduled to publish. It can be set only
-        # if the privacy status of the video is private. The value is specified in ISO
-        # 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        # The date and time when the video is scheduled to publish. It can be set
+        # only if the privacy status of the video is private. The value is specified
+        # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
+        # (<code>YYYY-MM-DDThh:mm:ss.sZ</code>) format.
         # Corresponds to the JSON property `publishAt`
-        # @return [DateTime]
+        # @return [String]
         attr_accessor :publish_at
       
-        # This value explains why YouTube rejected an uploaded video. This property is
-        # only present if the uploadStatus property indicates that the upload was
-        # rejected.
+        # This value explains why YouTube rejected an uploaded video. This
+        # property is only present if the <code>uploadStatus</code> property
+        # indicates that the upload was rejected.
         # Corresponds to the JSON property `rejectionReason`
         # @return [String]
         attr_accessor :rejection_reason
@@ -8817,43 +8829,45 @@ module Google
         end
       end
       
-      # Specifies suggestions on how to improve video content, including encoding
-      # hints, tag suggestions, and editor suggestions.
+      # Specifies suggestions on how to improve video content,
+      # including encoding hints, tag suggestions, and editor suggestions.
       class VideoSuggestions
         include Google::Apis::Core::Hashable
       
-        # A list of video editing operations that might improve the video quality or
-        # playback experience of the uploaded video.
+        # A list of video editing operations that might improve the video quality
+        # or playback experience of the uploaded video.
         # Corresponds to the JSON property `editorSuggestions`
         # @return [Array<String>]
         attr_accessor :editor_suggestions
       
-        # A list of errors that will prevent YouTube from successfully processing the
-        # uploaded video video. These errors indicate that, regardless of the video's
-        # current processing status, eventually, that status will almost certainly be
-        # failed.
+        # A list of errors that will prevent YouTube from successfully processing
+        # the uploaded video video. These errors indicate that, regardless of the
+        # video's current <a href="#processingProgress.processingStatus">processing
+        # status</a>, eventually, that status will almost certainly be
+        # <code>failed</code>.
         # Corresponds to the JSON property `processingErrors`
         # @return [Array<String>]
         attr_accessor :processing_errors
       
-        # A list of suggestions that may improve YouTube's ability to process the video.
+        # A list of suggestions that may improve YouTube's ability to process the
+        # video.
         # Corresponds to the JSON property `processingHints`
         # @return [Array<String>]
         attr_accessor :processing_hints
       
-        # A list of reasons why YouTube may have difficulty transcoding the uploaded
-        # video or that might result in an erroneous transcoding. These warnings are
-        # generated before YouTube actually processes the uploaded video file. In
-        # addition, they identify issues that are unlikely to cause the video processing
-        # to fail but that might cause problems such as sync issues, video artifacts, or
-        # a missing audio track.
+        # A list of reasons why YouTube may have difficulty transcoding the
+        # uploaded video or that might result in an erroneous transcoding.
+        # These warnings are generated before YouTube actually processes the
+        # uploaded video file. In addition, they identify issues that are unlikely
+        # to cause the video processing to fail but that might cause problems
+        # such as sync issues, video artifacts, or a missing audio track.
         # Corresponds to the JSON property `processingWarnings`
         # @return [Array<String>]
         attr_accessor :processing_warnings
       
-        # A list of keyword tags that could be added to the video's metadata to increase
-        # the likelihood that users will locate your video when searching or browsing on
-        # YouTube.
+        # A list of keyword tags that could be added to the video's metadata to
+        # increase the likelihood that users will locate your video when searching
+        # or browsing on YouTube.
         # Corresponds to the JSON property `tagSuggestions`
         # @return [Array<Google::Apis::YoutubeV3::VideoSuggestionsTagSuggestion>]
         attr_accessor :tag_suggestions
@@ -8877,10 +8891,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A set of video categories for which the tag is relevant. You can use this
-        # information to display appropriate tag suggestions based on the video category
-        # that the video uploader associates with the video. By default, tag suggestions
-        # are relevant for all categories if there are no restricts defined for the
-        # keyword.
+        # information to display appropriate tag suggestions based on the video
+        # category that the video uploader associates with the video. By default,
+        # tag suggestions are relevant for all categories if there are no restricts
+        # defined for the keyword.
         # Corresponds to the JSON property `categoryRestricts`
         # @return [Array<String>]
         attr_accessor :category_restricts
@@ -8905,23 +8919,25 @@ module Google
       class VideoTopicDetails
         include Google::Apis::Core::Hashable
       
-        # Similar to topic_id, except that these topics are merely relevant to the video.
-        # These are topics that may be mentioned in, or appear in the video. You can
-        # retrieve information about each topic using Freebase Topic API.
+        # Similar to topic_id, except that these topics are merely relevant to the
+        # video. These are topics that may be mentioned in, or appear in the video.
+        # You can retrieve information about each topic using <a
+        # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>.
         # Corresponds to the JSON property `relevantTopicIds`
         # @return [Array<String>]
         attr_accessor :relevant_topic_ids
       
-        # A list of Wikipedia URLs that provide a high-level description of the video's
-        # content.
+        # A list of Wikipedia URLs that provide a high-level description of the
+        # video's content.
         # Corresponds to the JSON property `topicCategories`
         # @return [Array<String>]
         attr_accessor :topic_categories
       
         # A list of Freebase topic IDs that are centrally associated with the video.
-        # These are topics that are centrally featured in the video, and it can be said
-        # that the video is mainly about each of these. You can retrieve information
-        # about each topic using the Freebase Topic API.
+        # These are topics that are centrally featured in the video, and it can be
+        # said that the video is mainly about each of these. You can retrieve
+        # information about each topic using the < a
+        # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>.
         # Corresponds to the JSON property `topicIds`
         # @return [Array<String>]
         attr_accessor :topic_ids
diff --git a/generated/google/apis/youtube_v3/representations.rb b/generated/google/apis/youtube_v3/representations.rb
index fa74b4914..ed71f2ffc 100644
--- a/generated/google/apis/youtube_v3/representations.rb
+++ b/generated/google/apis/youtube_v3/representations.rb
@@ -298,6 +298,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CommentSnippetAuthorChannelId
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CommentThread
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -544,36 +550,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class LiveChatPollClosedDetails
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class LiveChatPollEditedDetails
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class LiveChatPollItem
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class LiveChatPollOpenedDetails
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class LiveChatPollVotedDetails
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class LiveChatSuperChatDetails
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -712,18 +688,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Nonprofit
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class NonprofitId
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class PageInfo
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1030,12 +994,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GetVideoRatingResponse
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class ListVideosResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1090,6 +1048,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class VideoRatingListResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class VideoRecordingDetails
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1316,8 +1280,7 @@ module Google
           property :channel_title, as: 'channelTitle'
           property :description, as: 'description'
           property :group_id, as: 'groupId'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
           property :title, as: 'title'
@@ -1359,8 +1322,7 @@ module Google
           property :is_easy_reader, as: 'isEasyReader'
           property :is_large, as: 'isLarge'
           property :language, as: 'language'
-          property :last_updated, as: 'lastUpdated', type: DateTime
-      
+          property :last_updated, as: 'lastUpdated'
           property :name, as: 'name'
           property :status, as: 'status'
           property :track_kind, as: 'trackKind'
@@ -1466,8 +1428,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :content_owner, as: 'contentOwner'
-          property :time_linked, as: 'timeLinked', type: DateTime
-      
+          property :time_linked, as: 'timeLinked'
         end
       end
       
@@ -1619,8 +1580,7 @@ module Google
           property :description, as: 'description'
           property :localized, as: 'localized', class: Google::Apis::YoutubeV3::ChannelLocalization, decorator: Google::Apis::YoutubeV3::ChannelLocalization::Representation
       
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
           property :title, as: 'title'
@@ -1688,7 +1648,8 @@ module Google
       class CommentSnippet
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :author_channel_id, as: 'authorChannelId'
+          property :author_channel_id, as: 'authorChannelId', class: Google::Apis::YoutubeV3::CommentSnippetAuthorChannelId, decorator: Google::Apis::YoutubeV3::CommentSnippetAuthorChannelId::Representation
+      
           property :author_channel_url, as: 'authorChannelUrl'
           property :author_display_name, as: 'authorDisplayName'
           property :author_profile_image_url, as: 'authorProfileImageUrl'
@@ -1697,17 +1658,22 @@ module Google
           property :like_count, as: 'likeCount'
           property :moderation_status, as: 'moderationStatus'
           property :parent_id, as: 'parentId'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :text_display, as: 'textDisplay'
           property :text_original, as: 'textOriginal'
-          property :updated_at, as: 'updatedAt', type: DateTime
-      
+          property :updated_at, as: 'updatedAt'
           property :video_id, as: 'videoId'
           property :viewer_rating, as: 'viewerRating'
         end
       end
       
+      class CommentSnippetAuthorChannelId
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :value, as: 'value'
+        end
+      end
+      
       class CommentThread
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1982,6 +1948,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :backup_ingestion_address, as: 'backupIngestionAddress'
           property :ingestion_address, as: 'ingestionAddress'
+          property :rtmps_backup_ingestion_address, as: 'rtmpsBackupIngestionAddress'
+          property :rtmps_ingestion_address, as: 'rtmpsIngestionAddress'
           property :stream_name, as: 'streamName'
         end
       end
@@ -2064,8 +2032,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :bound_stream_id, as: 'boundStreamId'
-          property :bound_stream_last_update_time_ms, as: 'boundStreamLastUpdateTimeMs', type: DateTime
-      
+          property :bound_stream_last_update_time_ms, as: 'boundStreamLastUpdateTimeMs'
           property :closed_captions_type, as: 'closedCaptionsType'
           property :enable_auto_start, as: 'enableAutoStart'
           property :enable_auto_stop, as: 'enableAutoStop'
@@ -2081,7 +2048,6 @@ module Google
           property :projection, as: 'projection'
           property :record_from_start, as: 'recordFromStart'
           property :start_with_slate, as: 'startWithSlate'
-          property :stereo_layout, as: 'stereoLayout'
         end
       end
       
@@ -2106,21 +2072,15 @@ module Google
       class LiveBroadcastSnippet
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :actual_end_time, as: 'actualEndTime', type: DateTime
-      
-          property :actual_start_time, as: 'actualStartTime', type: DateTime
-      
-          property :broadcast_type, as: 'broadcastType'
+          property :actual_end_time, as: 'actualEndTime'
+          property :actual_start_time, as: 'actualStartTime'
           property :channel_id, as: 'channelId'
           property :description, as: 'description'
           property :is_default_broadcast, as: 'isDefaultBroadcast'
           property :live_chat_id, as: 'liveChatId'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
-          property :scheduled_end_time, as: 'scheduledEndTime', type: DateTime
-      
-          property :scheduled_start_time, as: 'scheduledStartTime', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
+          property :scheduled_end_time, as: 'scheduledEndTime'
+          property :scheduled_start_time, as: 'scheduledStartTime'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
           property :title, as: 'title'
@@ -2130,7 +2090,6 @@ module Google
       class LiveBroadcastStatistics
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :concurrent_viewers, :numeric_string => true, as: 'concurrentViewers'
           property :total_chat_count, :numeric_string => true, as: 'totalChatCount'
         end
       end
@@ -2222,8 +2181,7 @@ module Google
       
           property :kind, as: 'kind'
           property :next_page_token, as: 'nextPageToken'
-          property :offline_at, as: 'offlineAt', type: DateTime
-      
+          property :offline_at, as: 'offlineAt'
           property :page_info, as: 'pageInfo', class: Google::Apis::YoutubeV3::PageInfo, decorator: Google::Apis::YoutubeV3::PageInfo::Representation
       
           property :polling_interval_millis, as: 'pollingIntervalMillis'
@@ -2253,16 +2211,7 @@ module Google
       
           property :message_retracted_details, as: 'messageRetractedDetails', class: Google::Apis::YoutubeV3::LiveChatMessageRetractedDetails, decorator: Google::Apis::YoutubeV3::LiveChatMessageRetractedDetails::Representation
       
-          property :poll_closed_details, as: 'pollClosedDetails', class: Google::Apis::YoutubeV3::LiveChatPollClosedDetails, decorator: Google::Apis::YoutubeV3::LiveChatPollClosedDetails::Representation
-      
-          property :poll_edited_details, as: 'pollEditedDetails', class: Google::Apis::YoutubeV3::LiveChatPollEditedDetails, decorator: Google::Apis::YoutubeV3::LiveChatPollEditedDetails::Representation
-      
-          property :poll_opened_details, as: 'pollOpenedDetails', class: Google::Apis::YoutubeV3::LiveChatPollOpenedDetails, decorator: Google::Apis::YoutubeV3::LiveChatPollOpenedDetails::Representation
-      
-          property :poll_voted_details, as: 'pollVotedDetails', class: Google::Apis::YoutubeV3::LiveChatPollVotedDetails, decorator: Google::Apis::YoutubeV3::LiveChatPollVotedDetails::Representation
-      
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :super_chat_details, as: 'superChatDetails', class: Google::Apis::YoutubeV3::LiveChatSuperChatDetails, decorator: Google::Apis::YoutubeV3::LiveChatSuperChatDetails::Representation
       
           property :super_sticker_details, as: 'superStickerDetails', class: Google::Apis::YoutubeV3::LiveChatSuperStickerDetails, decorator: Google::Apis::YoutubeV3::LiveChatSuperStickerDetails::Representation
@@ -2313,49 +2262,6 @@ module Google
         end
       end
       
-      class LiveChatPollClosedDetails
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :poll_id, as: 'pollId'
-        end
-      end
-      
-      class LiveChatPollEditedDetails
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :id, as: 'id'
-          collection :items, as: 'items', class: Google::Apis::YoutubeV3::LiveChatPollItem, decorator: Google::Apis::YoutubeV3::LiveChatPollItem::Representation
-      
-          property :prompt, as: 'prompt'
-        end
-      end
-      
-      class LiveChatPollItem
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :description, as: 'description'
-          property :item_id, as: 'itemId'
-        end
-      end
-      
-      class LiveChatPollOpenedDetails
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :id, as: 'id'
-          collection :items, as: 'items', class: Google::Apis::YoutubeV3::LiveChatPollItem, decorator: Google::Apis::YoutubeV3::LiveChatPollItem::Representation
-      
-          property :prompt, as: 'prompt'
-        end
-      end
-      
-      class LiveChatPollVotedDetails
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :item_id, as: 'itemId'
-          property :poll_id, as: 'pollId'
-        end
-      end
-      
       class LiveChatSuperChatDetails
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2465,8 +2371,7 @@ module Google
           property :channel_id, as: 'channelId'
           property :description, as: 'description'
           property :is_default_stream, as: 'isDefaultStream'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :title, as: 'title'
         end
       end
@@ -2608,22 +2513,6 @@ module Google
         end
       end
       
-      class Nonprofit
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :nonprofit_id, as: 'nonprofitId', class: Google::Apis::YoutubeV3::NonprofitId, decorator: Google::Apis::YoutubeV3::NonprofitId::Representation
-      
-          property :nonprofit_legal_name, as: 'nonprofitLegalName'
-        end
-      end
-      
-      class NonprofitId
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :value, as: 'value'
-        end
-      end
-      
       class PageInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2680,8 +2569,7 @@ module Google
           property :note, as: 'note'
           property :start_at, as: 'startAt'
           property :video_id, as: 'videoId'
-          property :video_published_at, as: 'videoPublishedAt', type: DateTime
-      
+          property :video_published_at, as: 'videoPublishedAt'
         end
       end
       
@@ -2711,8 +2599,7 @@ module Google
           property :description, as: 'description'
           property :playlist_id, as: 'playlistId'
           property :position, as: 'position'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :resource_id, as: 'resourceId', class: Google::Apis::YoutubeV3::ResourceId, decorator: Google::Apis::YoutubeV3::ResourceId::Representation
       
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
@@ -2770,8 +2657,7 @@ module Google
           property :description, as: 'description'
           property :localized, as: 'localized', class: Google::Apis::YoutubeV3::PlaylistLocalization, decorator: Google::Apis::YoutubeV3::PlaylistLocalization::Representation
       
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           collection :tags, as: 'tags'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
@@ -2864,8 +2750,7 @@ module Google
           property :channel_title, as: 'channelTitle'
           property :description, as: 'description'
           property :live_broadcast_content, as: 'liveBroadcastContent'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
           property :title, as: 'title'
@@ -2906,8 +2791,7 @@ module Google
           property :cumulative_duration_months, as: 'cumulativeDurationMonths'
           property :sponsor_details, as: 'sponsorDetails', class: Google::Apis::YoutubeV3::ChannelProfileDetails, decorator: Google::Apis::YoutubeV3::ChannelProfileDetails::Representation
       
-          property :sponsor_since, as: 'sponsorSince', type: DateTime
-      
+          property :sponsor_since, as: 'sponsorSince'
         end
       end
       
@@ -2959,8 +2843,7 @@ module Google
           property :channel_id, as: 'channelId'
           property :channel_title, as: 'channelTitle'
           property :description, as: 'description'
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           property :resource_id, as: 'resourceId', class: Google::Apis::YoutubeV3::ResourceId, decorator: Google::Apis::YoutubeV3::ResourceId::Representation
       
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
@@ -3014,15 +2897,11 @@ module Google
           property :amount_micros, :numeric_string => true, as: 'amountMicros'
           property :channel_id, as: 'channelId'
           property :comment_text, as: 'commentText'
-          property :created_at, as: 'createdAt', type: DateTime
-      
+          property :created_at, as: 'createdAt'
           property :currency, as: 'currency'
           property :display_string, as: 'displayString'
-          property :is_super_chat_for_good, as: 'isSuperChatForGood'
           property :is_super_sticker_event, as: 'isSuperStickerEvent'
           property :message_type, as: 'messageType'
-          property :nonprofit, as: 'nonprofit', class: Google::Apis::YoutubeV3::Nonprofit, decorator: Google::Apis::YoutubeV3::Nonprofit::Representation
-      
           property :super_sticker_metadata, as: 'superStickerMetadata', class: Google::Apis::YoutubeV3::SuperStickerMetadata, decorator: Google::Apis::YoutubeV3::SuperStickerMetadata::Representation
       
           property :supporter_details, as: 'supporterDetails', class: Google::Apis::YoutubeV3::ChannelProfileDetails, decorator: Google::Apis::YoutubeV3::ChannelProfileDetails::Representation
@@ -3287,18 +3166,6 @@ module Google
         end
       end
       
-      class GetVideoRatingResponse
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :etag, as: 'etag'
-          property :event_id, as: 'eventId'
-          collection :items, as: 'items', class: Google::Apis::YoutubeV3::VideoRating, decorator: Google::Apis::YoutubeV3::VideoRating::Representation
-      
-          property :kind, as: 'kind'
-          property :visitor_id, as: 'visitorId'
-        end
-      end
-      
       class ListVideosResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3321,15 +3188,11 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :active_live_chat_id, as: 'activeLiveChatId'
-          property :actual_end_time, as: 'actualEndTime', type: DateTime
-      
-          property :actual_start_time, as: 'actualStartTime', type: DateTime
-      
+          property :actual_end_time, as: 'actualEndTime'
+          property :actual_start_time, as: 'actualStartTime'
           property :concurrent_viewers, :numeric_string => true, as: 'concurrentViewers'
-          property :scheduled_end_time, as: 'scheduledEndTime', type: DateTime
-      
-          property :scheduled_start_time, as: 'scheduledStartTime', type: DateTime
-      
+          property :scheduled_end_time, as: 'scheduledEndTime'
+          property :scheduled_start_time, as: 'scheduledStartTime'
         end
       end
       
@@ -3397,14 +3260,25 @@ module Google
         end
       end
       
+      class VideoRatingListResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :etag, as: 'etag'
+          property :event_id, as: 'eventId'
+          collection :items, as: 'items', class: Google::Apis::YoutubeV3::VideoRating, decorator: Google::Apis::YoutubeV3::VideoRating::Representation
+      
+          property :kind, as: 'kind'
+          property :visitor_id, as: 'visitorId'
+        end
+      end
+      
       class VideoRecordingDetails
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :location, as: 'location', class: Google::Apis::YoutubeV3::GeoPoint, decorator: Google::Apis::YoutubeV3::GeoPoint::Representation
       
           property :location_description, as: 'locationDescription'
-          property :recording_date, as: 'recordingDate', type: DateTime
-      
+          property :recording_date, as: 'recordingDate'
         end
       end
       
@@ -3420,8 +3294,7 @@ module Google
           property :live_broadcast_content, as: 'liveBroadcastContent'
           property :localized, as: 'localized', class: Google::Apis::YoutubeV3::VideoLocalization, decorator: Google::Apis::YoutubeV3::VideoLocalization::Representation
       
-          property :published_at, as: 'publishedAt', type: DateTime
-      
+          property :published_at, as: 'publishedAt'
           collection :tags, as: 'tags'
           property :thumbnails, as: 'thumbnails', class: Google::Apis::YoutubeV3::ThumbnailDetails, decorator: Google::Apis::YoutubeV3::ThumbnailDetails::Representation
       
@@ -3449,8 +3322,7 @@ module Google
           property :made_for_kids, as: 'madeForKids'
           property :privacy_status, as: 'privacyStatus'
           property :public_stats_viewable, as: 'publicStatsViewable'
-          property :publish_at, as: 'publishAt', type: DateTime
-      
+          property :publish_at, as: 'publishAt'
           property :rejection_reason, as: 'rejectionReason'
           property :self_declared_made_for_kids, as: 'selfDeclaredMadeForKids'
           property :upload_status, as: 'uploadStatus'
diff --git a/generated/google/apis/youtube_v3/service.rb b/generated/google/apis/youtube_v3/service.rb
index 76dea2d3d..7ff35e668 100644
--- a/generated/google/apis/youtube_v3/service.rb
+++ b/generated/google/apis/youtube_v3/service.rb
@@ -20,10 +20,10 @@ require 'google/apis/errors'
 module Google
   module Apis
     module YoutubeV3
-      # YouTube Data API
+      # YouTube Data API v3
       #
-      # Supports core YouTube features, such as uploading videos, creating and
-      #  managing playlists, searching for content, and much more.
+      # The YouTube Data API v3 is an API that provides access to YouTube data, such
+      #  as videos, playlists, and channels.
       #
       # @example
       #    require 'google/apis/youtube_v3'
@@ -31,7 +31,7 @@ module Google
       #    Youtube = Google::Apis::YoutubeV3 # Alias the module
       #    service = Youtube::YouTubeService.new
       #
-      # @see https://developers.google.com/youtube/v3
+      # @see https://developers.google.com/youtube/
       class YouTubeService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -39,38 +39,26 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  An opaque string that represents a user for quota purposes. Must not exceed 40
-        #  characters.
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
         attr_accessor :quota_user
 
-        # @return [String]
-        #  Deprecated. Please use quotaUser instead.
-        attr_accessor :user_ip
-
         def initialize
-          super('https://www.googleapis.com/', 'youtube/v3/')
+          super('https://www.googleapis.com/', '')
           @batch_path = 'batch/youtube/v3'
         end
         
-        # Posts a bulletin for a specific channel. (The user submitting the request must
-        # be authorized to act on the channel's behalf.)
-        # Note: Even though an activity resource can contain information about actions
-        # like a user rating a video or marking a video as a favorite, you need to use
-        # other API methods to generate those activity resources. For example, you would
-        # use the API's videos.rate() method to rate a video and the playlistItems.
-        # insert() method to mark a video as a favorite.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will include.
         # @param [Google::Apis::YoutubeV3::Activity] activity_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -83,8 +71,8 @@ module Google
         # @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 insert_activity(part, activity_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'activities', options)
+        def insert_activity(part, activity_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/activities', options)
           command.request_representation = Google::Apis::YoutubeV3::Activity::Representation
           command.request_object = activity_object
           command.response_representation = Google::Apis::YoutubeV3::Activity::Representation
@@ -92,63 +80,39 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of channel activity events that match the request criteria. For
-        # example, you can retrieve events associated with a particular channel, events
-        # associated with the user's subscriptions and Google+ friends, or the YouTube
-        # home page feed, which is customized for each user.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more activity
-        #   resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in an activity
-        #   resource, the snippet property contains other properties that identify the
-        #   type of activity, a display title for the activity, and so forth. If you set
-        #   part=snippet, the API response will also contain all of those nested
-        #   properties.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>activity</code> resource
+        #   properties that the API response will include.<br><br>If the parameter
+        #   identifies a property that contains child properties, the child properties
+        #   will be included in the response. For example, in an <code>activity</code>
+        #   resource, the <code>snippet</code> property contains other properties that
+        #   identify the type of activity, a display title for the activity, and so
+        #   forth. If you set <code><strong>part=snippet</strong></code>, the API
+        #   response will also contain all of those nested properties.
         # @param [String] channel_id
-        #   The channelId parameter specifies a unique YouTube channel ID. The API will
-        #   then return a list of that channel's activities.
         # @param [Boolean] home
-        #   Set this parameter's value to true to retrieve the activity feed that displays
-        #   on the YouTube home page for the currently authenticated user.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   Set this parameter's value to true to retrieve a feed of the authenticated
-        #   user's activities.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
-        # @param [DateTime] published_after
-        #   The publishedAfter parameter specifies the earliest date and time that an
-        #   activity could have occurred for that activity to be included in the API
-        #   response. If the parameter value specifies a day, but not a time, then any
-        #   activities that occurred that day will be included in the result set. The
-        #   value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
-        # @param [DateTime] published_before
-        #   The publishedBefore parameter specifies the date and time before which an
-        #   activity must have occurred for that activity to be included in the API
-        #   response. If the parameter value specifies a day, but not a time, then any
-        #   activities that occurred that day will be excluded from the result set. The
-        #   value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
+        # @param [String] published_after
+        # @param [String] published_before
         # @param [String] region_code
-        #   The regionCode parameter instructs the API to return results for the specified
-        #   country. The parameter value is an ISO 3166-1 alpha-2 country code. YouTube
-        #   uses this value when the authorized user's previous activity on YouTube does
-        #   not provide enough information to generate the activity feed.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -161,8 +125,8 @@ module Google
         # @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_activities(part, channel_id: nil, home: nil, max_results: nil, mine: nil, page_token: nil, published_after: nil, published_before: nil, region_code: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'activities', options)
+        def list_activities(part, channel_id: nil, home: nil, max_results: nil, mine: nil, page_token: nil, published_after: nil, published_before: nil, region_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/activities', options)
           command.response_representation = Google::Apis::YoutubeV3::ListActivitiesResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListActivitiesResponse
           command.query['channelId'] = channel_id unless channel_id.nil?
@@ -176,33 +140,30 @@ module Google
           command.query['regionCode'] = region_code unless region_code.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a specified caption track.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter identifies the caption track that is being deleted. The value
-        #   is a caption track ID as identified by the id property in a caption resource.
         # @param [String] on_behalf_of
         #   ID of the Google+ Page for the channel that the request is be on behalf of
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -215,53 +176,44 @@ module Google
         # @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 delete_caption(id, on_behalf_of: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'captions', options)
+        def delete_caption(id, on_behalf_of: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/captions', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOf'] = on_behalf_of unless on_behalf_of.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Downloads a caption track. The caption track is returned in its original
-        # format unless the request specifies a value for the tfmt parameter and in its
-        # original language unless the request specifies a value for the tlang parameter.
+        # Downloads a caption track.
         # @param [String] id
-        #   The id parameter identifies the caption track that is being retrieved. The
-        #   value is a caption track ID as identified by the id property in a caption
-        #   resource.
+        #   The ID of the caption track to download, required for One Platform.
         # @param [String] on_behalf_of
         #   ID of the Google+ Page for the channel that the request is be on behalf of
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
         # @param [String] tfmt
-        #   The tfmt parameter specifies that the caption track should be returned in a
-        #   specific format. If the parameter is not included in the request, the track is
-        #   returned in its original format.
+        #   Convert the captions into this format. Supported options are
+        #   sbv, srt, and vtt.
         # @param [String] tlang
-        #   The tlang parameter specifies that the API response should return a
-        #   translation of the specified caption track. The parameter value is an ISO 639-
-        #   1 two-letter language code that identifies the desired caption language. The
-        #   translation is generated by using machine translation, such as Google
-        #   Translate.
+        #   tlang is the language code; machine translate the captions into
+        #   this language.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] download_dest
         #   IO stream or filename to receive content download
         # @param [Google::Apis::RequestOptions] options
@@ -276,11 +228,11 @@ module Google
         # @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 download_caption(id, on_behalf_of: nil, on_behalf_of_content_owner: nil, tfmt: nil, tlang: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
+        def download_caption(id, on_behalf_of: nil, on_behalf_of_content_owner: nil, tfmt: nil, tlang: nil, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
           if download_dest.nil?
-            command = make_simple_command(:get, 'captions/{id}', options)
+            command = make_simple_command(:get, 'youtube/v3/captions/{id}', options)
           else
-            command = make_download_command(:get, 'captions/{id}', options)
+            command = make_download_command(:get, 'youtube/v3/captions/{id}', options)
             command.download_dest = download_dest
           end
           command.params['id'] = id unless id.nil?
@@ -290,42 +242,37 @@ module Google
           command.query['tlang'] = tlang unless tlang.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads a caption track.
-        # @param [String] part
-        #   The part parameter specifies the caption resource parts that the API response
-        #   will include. Set the parameter value to snippet.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>caption</code> resource parts that the API response will include. Set
+        #   the parameter value to <code>snippet</code>.
         # @param [Google::Apis::YoutubeV3::Caption] caption_object
         # @param [String] on_behalf_of
         #   ID of the Google+ Page for the channel that the request is be on behalf of
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
         # @param [Boolean] sync
-        #   The sync parameter indicates whether YouTube should automatically synchronize
-        #   the caption file with the audio track of the video. If you set the value to
-        #   true, YouTube will disregard any time codes that are in the uploaded caption
-        #   file and generate new time codes for the captions.
-        #   You should set the sync parameter to true if you are uploading a transcript,
-        #   which has no time codes, or if you suspect the time codes in your file are
-        #   incorrect and want YouTube to try to fix them.
+        #   Extra parameter to allow automatically syncing the uploaded
+        #   caption/transcript with the audio.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -342,11 +289,11 @@ module Google
         # @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 insert_caption(part, caption_object = nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, sync: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def insert_caption(part, caption_object = nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, sync: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:post, 'captions', options)
+            command = make_simple_command(:post, 'youtube/v3/captions', options)
           else
-            command = make_upload_command(:post, 'captions', options)
+            command = make_upload_command(:post, 'youtube/v3/captions', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -360,43 +307,39 @@ module Google
           command.query['sync'] = sync unless sync.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of caption tracks that are associated with a specified video.
-        # Note that the API response does not contain the actual captions and that the
-        # captions.download method provides the ability to retrieve a caption track.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more caption
-        #   resource parts that the API response will include. The part names that you can
-        #   include in the parameter value are id and snippet.
+        # Retrieves a list of resources, possibly filtered.
         # @param [String] video_id
-        #   The videoId parameter specifies the YouTube video ID of the video for which
-        #   the API should return caption tracks.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of IDs that identify the
-        #   caption resources that should be retrieved. Each ID must identify a caption
-        #   track associated with the specified video.
+        #   Returns the captions for the specified video.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>caption</code> resource parts
+        #   that the API response will include. The <code>part</code> names that you
+        #   can include in the parameter value are <code>id</code> and
+        #   <code>snippet</code>.
+        # @param [Array<String>, String] id
+        #   Returns the captions with the given IDs for Stubby or Apiary.
         # @param [String] on_behalf_of
         #   ID of the Google+ Page for the channel that the request is on behalf of.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -409,8 +352,8 @@ module Google
         # @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_captions(part, video_id, id: nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'captions', options)
+        def list_captions(video_id, part, id: nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/captions', options)
           command.response_representation = Google::Apis::YoutubeV3::ListCaptionsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListCaptionsResponse
           command.query['id'] = id unless id.nil?
@@ -420,44 +363,39 @@ module Google
           command.query['videoId'] = video_id unless video_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a caption track. When updating a caption track, you can change the
-        # track's draft status, upload a new caption file for the track, or both.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include. Set the property value to snippet if you are
-        #   updating the track's draft status. Otherwise, set the property value to id.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>caption</code> resource parts
+        #   that the API response will include. The <code>part</code> names that you
+        #   can include in the parameter value are <code>id</code> and
+        #   <code>snippet</code>.
         # @param [Google::Apis::YoutubeV3::Caption] caption_object
         # @param [String] on_behalf_of
-        #   ID of the Google+ Page for the channel that the request is be on behalf of
+        #   ID of the Google+ Page for the channel that the request is on behalf of.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
         # @param [Boolean] sync
-        #   Note: The API server only processes the parameter value if the request
-        #   contains an updated caption file.
-        #   The sync parameter indicates whether YouTube should automatically synchronize
-        #   the caption file with the audio track of the video. If you set the value to
-        #   true, YouTube will automatically synchronize the caption track with the audio
-        #   track.
+        #   Extra parameter to allow automatically syncing the uploaded
+        #   caption/transcript with the audio.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -474,11 +412,11 @@ module Google
         # @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 update_caption(part, caption_object = nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, sync: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def update_caption(part, caption_object = nil, on_behalf_of: nil, on_behalf_of_content_owner: nil, sync: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:put, 'captions', options)
+            command = make_simple_command(:put, 'youtube/v3/captions', options)
           else
-            command = make_upload_command(:put, 'captions', options)
+            command = make_upload_command(:put, 'youtube/v3/captions', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -492,47 +430,51 @@ module Google
           command.query['sync'] = sync unless sync.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads a channel banner image to YouTube. This method represents the first
-        # two steps in a three-step process to update the banner image for a channel:
-        # - Call the channelBanners.insert method to upload the binary image data to
-        # YouTube. The image must have a 16:9 aspect ratio and be at least 2120x1192
-        # pixels.
-        # - Extract the url property's value from the response that the API returns for
-        # step 1.
-        # - Call the channels.update method to update the channel's branding settings.
-        # Set the brandingSettings.image.bannerExternalUrl property's value to the URL
-        # obtained in step 2.
+        # Inserts a new resource into this collection.
         # @param [Google::Apis::YoutubeV3::ChannelBannerResource] channel_banner_resource_object
         # @param [String] channel_id
-        #   The channelId parameter identifies the YouTube channel to which the banner is
-        #   uploaded. The channelId parameter was introduced as a required parameter in
-        #   May 2017. As this was a backward-incompatible change, channelBanners.insert
-        #   requests that do not specify this parameter will not return an error until six
-        #   months have passed from the time that the parameter was introduced. Please see
-        #   the API Terms of Service for the official policy regarding backward
-        #   incompatible changes and the API revision history for the exact date that the
-        #   parameter was introduced.
+        #   Unused, channel_id is currently derived from the security context of the
+        #   requestor.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the request's authorization credentials identify a YouTube CMS user
+        #   who is acting on behalf of the content owner specified in the parameter
+        #   value. This parameter is intended for YouTube content partners that own and
+        #   manage many different YouTube channels. It allows content owners to
+        #   authenticate once and get access to all their video and channel data,
+        #   without having to provide authentication credentials for each individual
+        #   channel. The actual CMS account that the user authenticates with must be
+        #   linked to the specified YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -549,11 +491,11 @@ module Google
         # @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 insert_channel_banner(channel_banner_resource_object = nil, channel_id: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def insert_channel_banner(channel_banner_resource_object = nil, channel_id: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:post, 'channelBanners/insert', options)
+            command = make_simple_command(:post, 'youtube/v3/channelBanners/insert', options)
           else
-            command = make_upload_command(:post, 'channelBanners/insert', options)
+            command = make_upload_command(:post, 'youtube/v3/channelBanners/insert', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -563,34 +505,32 @@ module Google
           command.response_class = Google::Apis::YoutubeV3::ChannelBannerResource
           command.query['channelId'] = channel_id unless channel_id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
+          command.query['onBehalfOfContentOwnerChannel'] = on_behalf_of_content_owner_channel unless on_behalf_of_content_owner_channel.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a channelSection.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the YouTube channelSection ID for the resource that
-        #   is being deleted. In a channelSection resource, the id property specifies the
-        #   YouTube channelSection ID.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -603,57 +543,61 @@ module Google
         # @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 delete_channel_section(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'channelSections', options)
+        def delete_channel_section(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/channelSections', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a channelSection for the authenticated user's channel.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part names that you can include in the parameter value are snippet and
-        #   contentDetails.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>The <code>part</code> names that you can include in the
+        #   parameter value are <code>snippet</code> and <code>contentDetails</code>.
         # @param [Google::Apis::YoutubeV3::ChannelSection] channel_section_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -666,8 +610,8 @@ module Google
         # @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 insert_channel_section(part, channel_section_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'channelSections', options)
+        def insert_channel_section(part, channel_section_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/channelSections', options)
           command.request_representation = Google::Apis::YoutubeV3::ChannelSection::Representation
           command.request_object = channel_section_object
           command.response_representation = Google::Apis::YoutubeV3::ChannelSection::Representation
@@ -677,57 +621,48 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns channelSection resources that match the API request criteria.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   channelSection resource properties that the API response will include. The
-        #   part names that you can include in the parameter value are id, snippet, and
-        #   contentDetails.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a
-        #   channelSection resource, the snippet property contains other properties, such
-        #   as a display title for the channelSection. If you set part=snippet, the API
-        #   response will also contain all of those nested properties.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>channelSection</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, and <code>contentDetails</code>.<br><br>If the
+        #   parameter identifies a property that contains child properties, the child
+        #   properties will be included in the response. For example, in a
+        #   <code>channelSection</code> resource, the <code>snippet</code> property
+        #   contains other properties, such as a display title for the channelSection.
+        #   If you set <code><strong>part=snippet</strong></code>, the API response
+        #   will also contain all of those nested properties.
         # @param [String] channel_id
-        #   The channelId parameter specifies a YouTube channel ID. The API will only
-        #   return that channel's channelSections.
+        #   Return the ChannelSections owned by the specified channel ID.
         # @param [String] hl
-        #   The hl parameter indicates that the snippet.localized property values in the
-        #   returned channelSection resources should be in the specified language if
-        #   localized values for that language are available. For example, if the API
-        #   request specifies hl=de, the snippet.localized properties in the API response
-        #   will contain German titles if German titles are available. Channel owners can
-        #   provide localized channel section titles using either the channelSections.
-        #   insert or channelSections.update method.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube
-        #   channelSection ID(s) for the resource(s) that are being retrieved. In a
-        #   channelSection resource, the id property specifies the YouTube channelSection
-        #   ID.
+        #   Return content in specified language
+        # @param [Array<String>, String] id
+        #   Return the ChannelSections with the given IDs for Stubby or Apiary.
         # @param [Boolean] mine
-        #   Set this parameter's value to true to retrieve a feed of the authenticated
-        #   user's channelSections.
+        #   Return the ChannelSections owned by the authenticated user.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -740,8 +675,8 @@ module Google
         # @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_channel_sections(part, channel_id: nil, hl: nil, id: nil, mine: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'channelSections', options)
+        def list_channel_sections(part, channel_id: nil, hl: nil, id: nil, mine: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/channelSections', options)
           command.response_representation = Google::Apis::YoutubeV3::ListChannelSectionsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListChannelSectionsResponse
           command.query['channelId'] = channel_id unless channel_id.nil?
@@ -752,35 +687,35 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Update a channelSection.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part names that you can include in the parameter value are snippet and
-        #   contentDetails.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>The <code>part</code> names that you can include in the
+        #   parameter value are <code>snippet</code> and <code>contentDetails</code>.
         # @param [Google::Apis::YoutubeV3::ChannelSection] channel_section_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -793,8 +728,8 @@ module Google
         # @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 update_channel_section(part, channel_section_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'channelSections', options)
+        def update_channel_section(part, channel_section_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/channelSections', options)
           command.request_representation = Google::Apis::YoutubeV3::ChannelSection::Representation
           command.request_object = channel_section_object
           command.response_representation = Google::Apis::YoutubeV3::ChannelSection::Representation
@@ -803,69 +738,64 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a collection of zero or more channel resources that match the request
-        # criteria.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more channel
-        #   resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a channel
-        #   resource, the contentDetails property contains other properties, such as the
-        #   uploads properties. As such, if you set part=contentDetails, the API response
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>channel</code> resource
+        #   properties that the API response will include.<br><br>If the parameter
+        #   identifies a property that contains child properties, the child properties
+        #   will be included in the response. For example, in a <code>channel</code>
+        #   resource, the <code>contentDetails</code> property contains other
+        #   properties, such as the <code>uploads</code> properties. As such, if you
+        #   set <code><strong>part=contentDetails</strong></code>, the API response
         #   will also contain all of those nested properties.
         # @param [String] category_id
-        #   The categoryId parameter specifies a YouTube guide category, thereby
-        #   requesting YouTube channels associated with that category.
+        #   Return the channels within the specified guide category ID.
         # @param [String] for_username
-        #   The forUsername parameter specifies a YouTube username, thereby requesting the
-        #   channel associated with that username.
+        #   Return the channel associated with a YouTube username.
         # @param [String] hl
-        #   The hl parameter should be used for filter out the properties that are not in
-        #   the given language. Used for the brandingSettings part.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube channel ID(s)
-        #   for the resource(s) that are being retrieved. In a channel resource, the id
-        #   property specifies the channel's YouTube channel ID.
+        #   Stands for "host language". Specifies the localization language of the
+        #   metadata to be filled into snippet.localized. The field is filled with the
+        #   default metadata if there is no localization in the specified language.
+        #   The parameter value must be a language code included in the list returned
+        #   by the i18nLanguages.list method (e.g. en_US, es_MX).
+        # @param [Array<String>, String] id
+        #   Return the channels with the specified IDs.
         # @param [Boolean] managed_by_me
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   Set this parameter's value to true to instruct the API to only return channels
-        #   managed by the content owner that the onBehalfOfContentOwner parameter
-        #   specifies. The user must be authenticated as a CMS account linked to the
-        #   specified content owner and onBehalfOfContentOwner must be provided.
+        #   Return the channels managed by the authenticated user.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   Set this parameter's value to true to instruct the API to only return channels
-        #   owned by the authenticated user.
+        #   Return the ids of channels owned by the authenticated user.
         # @param [Boolean] my_subscribers
-        #   Use the subscriptions.list method and its mySubscribers parameter to retrieve
-        #   a list of subscribers to the authenticated user's channel.
+        #   Return the channels subscribed to the authenticated user
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -878,8 +808,8 @@ module Google
         # @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_channels(part, category_id: nil, for_username: nil, hl: nil, id: nil, managed_by_me: nil, max_results: nil, mine: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'channels', options)
+        def list_channels(part, category_id: nil, for_username: nil, hl: nil, id: nil, managed_by_me: nil, max_results: nil, mine: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/channels', options)
           command.response_representation = Google::Apis::YoutubeV3::ListChannelsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListChannelsResponse
           command.query['categoryId'] = category_id unless category_id.nil?
@@ -895,39 +825,36 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a channel's metadata. Note that this method currently only supports
-        # updates to the channel resource's brandingSettings and invideoPromotion
-        # objects and their child properties.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The API currently only allows the parameter value to be set to either
-        #   brandingSettings or invideoPromotion. (You cannot update both of those parts
-        #   with a single request.)
-        #   Note that this method overrides the existing values for all of the mutable
-        #   properties that are contained in any parts that the parameter value specifies.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>The API currently only allows the parameter value to be
+        #   set to either <code>brandingSettings</code> or
+        #   <code>invideoPromotion</code>. (You cannot update both of those parts with
+        #   a single request.)<br/><br/>Note that this method overrides the existing
+        #   values for all of the mutable properties that are contained in any parts
+        #   that the parameter value specifies.
         # @param [Google::Apis::YoutubeV3::Channel] channel_object
         # @param [String] on_behalf_of_content_owner
-        #   The onBehalfOfContentOwner parameter indicates that the authenticated user is
-        #   acting on behalf of the content owner specified in the parameter value. This
-        #   parameter is intended for YouTube content partners that own and manage many
-        #   different YouTube channels. It allows content owners to authenticate once and
-        #   get access to all their video and channel data, without having to provide
-        #   authentication credentials for each individual channel. The actual CMS account
-        #   that the user authenticates with needs to be linked to the specified YouTube
-        #   content owner.
+        #   The <code><strong>onBehalfOfContentOwner</strong></code> parameter
+        #   indicates that the authenticated user is acting on behalf of the content
+        #   owner specified in the parameter value. This parameter is intended for
+        #   YouTube content partners that own and manage many different YouTube
+        #   channels. It allows content owners to authenticate once and get access to
+        #   all their video and channel data, without having to provide authentication
+        #   credentials for each individual channel. The actual CMS account that the
+        #   user authenticates with needs to be linked to the specified YouTube content
+        #   owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -940,8 +867,8 @@ module Google
         # @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 update_channel(part, channel_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'channels', options)
+        def update_channel(part, channel_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/channels', options)
           command.request_representation = Google::Apis::YoutubeV3::Channel::Representation
           command.request_object = channel_object
           command.response_representation = Google::Apis::YoutubeV3::Channel::Representation
@@ -950,24 +877,21 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new top-level comment. To add a reply to an existing comment, use
-        # the comments.insert method instead.
-        # @param [String] part
-        #   The part parameter identifies the properties that the API response will
-        #   include. Set the parameter value to snippet. The snippet part has a quota cost
-        #   of 2 units.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter identifies the properties
+        #   that the API response will include. Set the parameter value to
+        #   <code>snippet</code>. The <code>snippet</code> part has a quota cost of 2
+        #   units.
         # @param [Google::Apis::YoutubeV3::CommentThread] comment_thread_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -980,8 +904,8 @@ module Google
         # @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 insert_comment_thread(part, comment_thread_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'commentThreads', options)
+        def insert_comment_thread(part, comment_thread_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/commentThreads', options)
           command.request_representation = Google::Apis::YoutubeV3::CommentThread::Representation
           command.request_object = comment_thread_object
           command.response_representation = Google::Apis::YoutubeV3::CommentThread::Representation
@@ -989,65 +913,47 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of comment threads that match the API request parameters.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   commentThread resource properties that the API response will include.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>commentThread</code> resource
+        #   properties that the API response will include.
         # @param [String] all_threads_related_to_channel_id
-        #   The allThreadsRelatedToChannelId parameter instructs the API to return all
-        #   comment threads associated with the specified channel. The response can
-        #   include comments about the channel or about the channel's videos.
+        #   Returns the comment threads of all videos of the channel and the
+        #   channel comments as well.
         # @param [String] channel_id
-        #   The channelId parameter instructs the API to return comment threads containing
-        #   comments about the specified channel. (The response will not include comments
-        #   left on videos that the channel uploaded.)
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of comment thread IDs for
-        #   the resources that should be retrieved.
+        #   Returns the comment threads for all the channel comments (ie does not
+        #   include comments left on videos).
+        # @param [Array<String>, String] id
+        #   Returns the comment threads with the given IDs for Stubby or Apiary.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] moderation_status
-        #   Set this parameter to limit the returned comment threads to a particular
-        #   moderation state.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   Limits the returned comment threads to those with the specified
+        #   moderation status. Not compatible with the 'id' filter.
+        #   Valid values: published, heldForReview, likelySpam.
         # @param [String] order
-        #   The order parameter specifies the order in which the API response should list
-        #   comment threads. Valid values are:
-        #   - time - Comment threads are ordered by time. This is the default behavior.
-        #   - relevance - Comment threads are ordered by relevance.Note: This parameter is
-        #   not supported for use in conjunction with the id parameter.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken property identifies
-        #   the next page of the result that can be retrieved.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] search_terms
-        #   The searchTerms parameter instructs the API to limit the API response to only
-        #   contain comments that contain the specified search terms.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   Limits the returned comment threads to those matching the specified
+        #   key words. Not compatible with the 'id' filter.
         # @param [String] text_format
-        #   Set this parameter's value to html or plainText to instruct the API to return
-        #   the comments left by users in html formatted or in plain text.
+        #   The requested text format for the returned comments.
         # @param [String] video_id
-        #   The videoId parameter instructs the API to return comment threads associated
-        #   with the specified video ID.
+        #   Returns the comment threads of the specified video.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1060,8 +966,8 @@ module Google
         # @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_comment_threads(part, all_threads_related_to_channel_id: nil, channel_id: nil, id: nil, max_results: nil, moderation_status: nil, order: nil, page_token: nil, search_terms: nil, text_format: nil, video_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'commentThreads', options)
+        def list_comment_threads(part, all_threads_related_to_channel_id: nil, channel_id: nil, id: nil, max_results: nil, moderation_status: nil, order: nil, page_token: nil, search_terms: nil, text_format: nil, video_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/commentThreads', options)
           command.response_representation = Google::Apis::YoutubeV3::ListCommentThreadsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListCommentThreadsResponse
           command.query['allThreadsRelatedToChannelId'] = all_threads_related_to_channel_id unless all_threads_related_to_channel_id.nil?
@@ -1077,24 +983,22 @@ module Google
           command.query['videoId'] = video_id unless video_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the top-level comment in a comment thread.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of commentThread resource
-        #   properties that the API response will include. You must at least include the
-        #   snippet part in the parameter value since that part contains all of the
-        #   properties that the API request can update.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of <code>commentThread</code> resource properties that
+        #   the API response will include. You must at least include the
+        #   <code>snippet</code> part in the parameter value since that part contains
+        #   all of the properties that the API request can update.
         # @param [Google::Apis::YoutubeV3::CommentThread] comment_thread_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1107,8 +1011,8 @@ module Google
         # @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 update_comment_thread(part, comment_thread_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'commentThreads', options)
+        def update_comment_thread(part, comment_thread_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/commentThreads', options)
           command.request_representation = Google::Apis::YoutubeV3::CommentThread::Representation
           command.request_object = comment_thread_object
           command.response_representation = Google::Apis::YoutubeV3::CommentThread::Representation
@@ -1116,21 +1020,16 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a comment.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the comment ID for the resource that is being
-        #   deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1143,29 +1042,26 @@ module Google
         # @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 delete_comment(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'comments', options)
+        def delete_comment(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/comments', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a reply to an existing comment. Note: To create a top-level comment,
-        # use the commentThreads.insert method.
-        # @param [String] part
-        #   The part parameter identifies the properties that the API response will
-        #   include. Set the parameter value to snippet. The snippet part has a quota cost
-        #   of 2 units.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter identifies the properties
+        #   that the API response will include. Set the parameter value to
+        #   <code>snippet</code>. The <code>snippet</code> part has a quota cost of 2
+        #   units.
         # @param [Google::Apis::YoutubeV3::Comment] comment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1178,8 +1074,8 @@ module Google
         # @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 insert_comment(part, comment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'comments', options)
+        def insert_comment(part, comment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/comments', options)
           command.request_representation = Google::Apis::YoutubeV3::Comment::Representation
           command.request_object = comment_object
           command.response_representation = Google::Apis::YoutubeV3::Comment::Representation
@@ -1187,44 +1083,36 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of comments that match the API request parameters.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more comment
-        #   resource properties that the API response will include.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of comment IDs for the
-        #   resources that are being retrieved. In a comment resource, the id property
-        #   specifies the comment's ID.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>comment</code> resource
+        #   properties that the API response will include.
+        # @param [Array<String>, String] id
+        #   Returns the comments with the given IDs for One Platform.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken property identifies
-        #   the next page of the result that can be retrieved.
-        #   Note: This parameter is not supported for use in conjunction with the id
-        #   parameter.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] parent_id
-        #   The parentId parameter specifies the ID of the comment for which replies
-        #   should be retrieved.
-        #   Note: YouTube currently supports replies only for top-level comments. However,
-        #   replies to replies may be supported in the future.
+        #   Returns replies to the specified comment.
+        #   Note, currently YouTube features only one level of replies (ie replies
+        #   to top level comments). However replies to replies may be supported in
+        #   the future.
         # @param [String] text_format
-        #   This parameter indicates whether the API should return comments formatted as
-        #   HTML or as plain text.
+        #   The requested text format for the returned comments.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1237,8 +1125,8 @@ module Google
         # @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_comments(part, id: nil, max_results: nil, page_token: nil, parent_id: nil, text_format: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'comments', options)
+        def list_comments(part, id: nil, max_results: nil, page_token: nil, parent_id: nil, text_format: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/comments', options)
           command.response_representation = Google::Apis::YoutubeV3::ListCommentsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListCommentsResponse
           command.query['id'] = id unless id.nil?
@@ -1249,22 +1137,18 @@ module Google
           command.query['textFormat'] = text_format unless text_format.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Expresses the caller's opinion that one or more comments should be flagged as
-        # spam.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of IDs of comments that the
-        #   caller believes should be classified as spam.
+        # Expresses the caller's opinion that one or more comments should be flagged
+        # as spam.
+        # @param [Array<String>, String] id
+        #   Flags the comments with the given IDs as spam in the caller's opinion.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1277,35 +1161,33 @@ module Google
         # @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 mark_comment_as_spam(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'comments/markAsSpam', options)
+        def mark_comment_as_spam(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/comments/markAsSpam', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the moderation status of one or more comments. The API request must be
-        # authorized by the owner of the channel or video associated with the comments.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of IDs that identify the
-        #   comments for which you are updating the moderation status.
+        # Sets the moderation status of one or more comments.
+        # @param [Array<String>, String] id
+        #   Modifies the moderation status of the comments with the given IDs
         # @param [String] moderation_status
-        #   Identifies the new moderation status of the specified comments.
+        #   Specifies the requested moderation status. Note, comments can be in
+        #   statuses, which are not available through this call. For example, this
+        #   call does not allow to mark a comment as 'likely spam'.
+        #   Valid values: MODERATION_STATUS_PUBLISHED,
+        #   MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.
         # @param [Boolean] ban_author
-        #   The banAuthor parameter lets you indicate that you want to automatically
-        #   reject any additional comments written by the comment's author. Set the
-        #   parameter value to true to ban the author.
-        #   Note: This parameter is only valid if the moderationStatus parameter is also
-        #   set to rejected.
+        #   If set to true the author of the comment gets added to the ban list.
+        #   This means all future comments of the author will autmomatically be
+        #   rejected.
+        #   Only valid in combination with STATUS_REJECTED.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1318,30 +1200,28 @@ module Google
         # @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 set_comment_moderation_status(id, moderation_status, ban_author: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'comments/setModerationStatus', options)
+        def set_comment_moderation_status(id, moderation_status, ban_author: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/comments/setModerationStatus', options)
           command.query['banAuthor'] = ban_author unless ban_author.nil?
           command.query['id'] = id unless id.nil?
           command.query['moderationStatus'] = moderation_status unless moderation_status.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies a comment.
-        # @param [String] part
-        #   The part parameter identifies the properties that the API response will
-        #   include. You must at least include the snippet part in the parameter value
-        #   since that part contains all of the properties that the API request can update.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter identifies the properties
+        #   that the API response will include. You must at least include the
+        #   <code>snippet</code> part in the parameter value since that part contains
+        #   all of the properties that the API request can update.
         # @param [Google::Apis::YoutubeV3::Comment] comment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1354,8 +1234,8 @@ module Google
         # @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 update_comment(part, comment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'comments', options)
+        def update_comment(part, comment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/comments', options)
           command.request_representation = Google::Apis::YoutubeV3::Comment::Representation
           command.request_object = comment_object
           command.response_representation = Google::Apis::YoutubeV3::Comment::Representation
@@ -1363,33 +1243,24 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of categories that can be associated with YouTube channels.
-        # @param [String] part
-        #   The part parameter specifies the guideCategory resource properties that the
-        #   API response will include. Set the parameter value to snippet.
+        # Retrieves a list of guide categories.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>guideCategory</code> resource properties that the API response will
+        #   include. Set the parameter value to <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter specifies the language that will be used for text values in
-        #   the API response.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube channel
-        #   category ID(s) for the resource(s) that are being retrieved. In a
-        #   guideCategory resource, the id property specifies the YouTube channel category
-        #   ID.
+        # @param [Array<String>, String] id
+        #   Return the guide categories with the given IDs.
         # @param [String] region_code
-        #   The regionCode parameter instructs the API to return the list of guide
-        #   categories available in the specified country. The parameter value is an ISO
-        #   3166-1 alpha-2 country code.
+        #   Return all categories in the given region code.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1402,8 +1273,8 @@ module Google
         # @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_guide_categories(part, hl: nil, id: nil, region_code: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'guideCategories', options)
+        def list_guide_categories(part, hl: nil, id: nil, region_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/guideCategories', options)
           command.response_representation = Google::Apis::YoutubeV3::ListGuideCategoriesResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListGuideCategoriesResponse
           command.query['hl'] = hl unless hl.nil?
@@ -1412,24 +1283,20 @@ module Google
           command.query['regionCode'] = region_code unless region_code.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of application languages that the YouTube website supports.
-        # @param [String] part
-        #   The part parameter specifies the i18nLanguage resource properties that the API
-        #   response will include. Set the parameter value to snippet.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>i18nLanguage</code> resource properties that the API response will
+        #   include. Set the parameter value to <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter specifies the language that should be used for text values in
-        #   the API response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1442,32 +1309,28 @@ module Google
         # @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_i18n_languages(part, hl: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'i18nLanguages', options)
+        def list_i18n_languages(part, hl: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/i18nLanguages', options)
           command.response_representation = Google::Apis::YoutubeV3::ListI18nLanguagesResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListI18nLanguagesResponse
           command.query['hl'] = hl unless hl.nil?
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of content regions that the YouTube website supports.
-        # @param [String] part
-        #   The part parameter specifies the i18nRegion resource properties that the API
-        #   response will include. Set the parameter value to snippet.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>i18nRegion</code> resource properties that the API response will
+        #   include. Set the parameter value to <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter specifies the language that should be used for text values in
-        #   the API response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1480,66 +1343,66 @@ module Google
         # @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_i18n_regions(part, hl: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'i18nRegions', options)
+        def list_i18n_regions(part, hl: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/i18nRegions', options)
           command.response_representation = Google::Apis::YoutubeV3::ListI18nRegionsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListI18nRegionsResponse
           command.query['hl'] = hl unless hl.nil?
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Binds a YouTube broadcast to a stream or removes an existing binding between a
-        # broadcast and a stream. A broadcast can only be bound to one video stream,
-        # though a video stream may be bound to more than one broadcast.
+        # Bind a broadcast to a stream.
         # @param [String] id
-        #   The id parameter specifies the unique ID of the broadcast that is being bound
-        #   to a video stream.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   liveBroadcast resource properties that the API response will include. The part
-        #   names that you can include in the parameter value are id, snippet,
-        #   contentDetails, and status.
+        #   Broadcast to bind to the stream
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>liveBroadcast</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, <code>contentDetails</code>, and <code>status</code>.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] stream_id
-        #   The streamId parameter specifies the unique ID of the video stream that is
-        #   being bound to a broadcast. If this parameter is omitted, the API will remove
-        #   any existing binding between the broadcast and a video stream.
+        #   Stream to bind, if not set unbind the current one.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1552,8 +1415,8 @@ module Google
         # @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 bind_live_broadcast(id, part, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, stream_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveBroadcasts/bind', options)
+        def bind_live_broadcast(id, part, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, stream_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveBroadcasts/bind', options)
           command.response_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
           command.response_class = Google::Apis::YoutubeV3::LiveBroadcast
           command.query['id'] = id unless id.nil?
@@ -1563,71 +1426,69 @@ module Google
           command.query['streamId'] = stream_id unless stream_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Controls the settings for a slate that can be displayed in the broadcast
-        # stream.
+        # Slate and recording control of the live broadcast.
+        # Support actions: slate on/off, recording start/stop/pause/resume.
+        # Design doc: goto/yt-api-liveBroadcast-control
         # @param [String] id
-        #   The id parameter specifies the YouTube live broadcast ID that uniquely
-        #   identifies the broadcast in which the slate is being updated.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   liveBroadcast resource properties that the API response will include. The part
-        #   names that you can include in the parameter value are id, snippet,
-        #   contentDetails, and status.
+        #   Broadcast to operate.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>liveBroadcast</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, <code>contentDetails</code>, and <code>status</code>.
         # @param [Boolean] display_slate
-        #   The displaySlate parameter specifies whether the slate is being enabled or
-        #   disabled.
+        #   Whether display or hide slate.
         # @param [Fixnum] offset_time_ms
-        #   The offsetTimeMs parameter specifies a positive time offset when the specified
-        #   slate change will occur. The value is measured in milliseconds from the
-        #   beginning of the broadcast's monitor stream, which is the time that the
-        #   testing phase for the broadcast began. Even though it is specified in
-        #   milliseconds, the value is actually an approximation, and YouTube completes
-        #   the requested action as closely as possible to that time.
-        #   If you do not specify a value for this parameter, then YouTube performs the
-        #   action as soon as possible. See the Getting started guide for more details.
-        #   Important: You should only specify a value for this parameter if your
-        #   broadcast stream is delayed.
+        #   The exact time when the actions (e.g. slate on) are executed.
+        #   It is an offset from the first frame of the monitor stream.
+        #   If not set, it means "now" or ASAP.
+        #   This field should not be set if the monitor stream is disabled,
+        #   otherwise an error will be returned.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
-        # @param [DateTime] walltime
-        #   The walltime parameter specifies the wall clock time at which the specified
-        #   slate change will occur. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:
-        #   ss.sssZ) format.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
+        # @param [String] walltime
+        #   The wall clock time at which the action should be executed.
+        #   Only one of offset_time_ms and walltime may be set at a time.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1640,8 +1501,8 @@ module Google
         # @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 control_live_broadcast(id, part, display_slate: nil, offset_time_ms: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, walltime: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveBroadcasts/control', options)
+        def control_live_broadcast(id, part, display_slate: nil, offset_time_ms: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, walltime: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveBroadcasts/control', options)
           command.response_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
           command.response_class = Google::Apis::YoutubeV3::LiveBroadcast
           command.query['displaySlate'] = display_slate unless display_slate.nil?
@@ -1653,47 +1514,49 @@ module Google
           command.query['walltime'] = walltime unless walltime.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a broadcast.
+        # Delete a given broadcast.
         # @param [String] id
-        #   The id parameter specifies the YouTube live broadcast ID for the resource that
-        #   is being deleted.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1706,58 +1569,63 @@ module Google
         # @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 delete_live_broadcast(id, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'liveBroadcasts', options)
+        def delete_live_broadcast(id, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/liveBroadcasts', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['onBehalfOfContentOwnerChannel'] = on_behalf_of_content_owner_channel unless on_behalf_of_content_owner_channel.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a broadcast.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part properties that you can include in the parameter value are id,
-        #   snippet, contentDetails, and status.
+        # Inserts a new stream for the authenticated user.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br><br>The <code>part</code> properties that you can include in
+        #   the parameter value are <code>id</code>, <code>snippet</code>,
+        #   <code>contentDetails</code>, and <code>status</code>.
         # @param [Google::Apis::YoutubeV3::LiveBroadcast] live_broadcast_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1770,8 +1638,8 @@ module Google
         # @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 insert_live_broadcast(part, live_broadcast_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveBroadcasts', options)
+        def insert_live_broadcast(part, live_broadcast_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveBroadcasts', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
           command.request_object = live_broadcast_object
           command.response_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
@@ -1781,71 +1649,69 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of YouTube broadcasts that match the API request parameters.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   liveBroadcast resource properties that the API response will include. The part
-        #   names that you can include in the parameter value are id, snippet,
-        #   contentDetails, and status.
+        # Retrieve the list of broadcasts associated with the given channel.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>liveBroadcast</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, <code>contentDetails</code>, and <code>status</code>.
         # @param [String] broadcast_status
-        #   The broadcastStatus parameter filters the API response to only include
-        #   broadcasts with the specified status.
+        #   Return broadcasts with a certain status, e.g. active broadcasts.
         # @param [String] broadcast_type
-        #   The broadcastType parameter filters the API response to only include
-        #   broadcasts with the specified type. This is only compatible with the mine
-        #   filter for now.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of YouTube broadcast IDs
-        #   that identify the broadcasts being retrieved. In a liveBroadcast resource, the
-        #   id property specifies the broadcast's ID.
+        #   Return only broadcasts with the selected type.
+        # @param [Array<String>, String] id
+        #   Return broadcasts with the given ids from Stubby or Apiary.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   The mine parameter can be used to instruct the API to only return broadcasts
-        #   owned by the authenticated user. Set the parameter value to true to only
-        #   retrieve your own broadcasts.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1858,8 +1724,8 @@ module Google
         # @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_live_broadcasts(part, broadcast_status: nil, broadcast_type: nil, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'liveBroadcasts', options)
+        def list_live_broadcasts(part, broadcast_status: nil, broadcast_type: nil, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/liveBroadcasts', options)
           command.response_representation = Google::Apis::YoutubeV3::ListLiveBroadcastsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListLiveBroadcastsResponse
           command.query['broadcastStatus'] = broadcast_status unless broadcast_status.nil?
@@ -1873,62 +1739,58 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Changes the status of a YouTube live broadcast and initiates any processes
-        # associated with the new status. For example, when you transition a broadcast's
-        # status to testing, YouTube starts to transmit video to that broadcast's
-        # monitor stream. Before calling this method, you should confirm that the value
-        # of the status.streamStatus property for the stream bound to your broadcast is
-        # active.
-        # @param [String] broadcast_status
-        #   The broadcastStatus parameter identifies the state to which the broadcast is
-        #   changing. Note that to transition a broadcast to either the testing or live
-        #   state, the status.streamStatus must be active for the stream that the
-        #   broadcast is bound to.
+        # Transition a broadcast to a given status.
         # @param [String] id
-        #   The id parameter specifies the unique ID of the broadcast that is
-        #   transitioning to another status.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   liveBroadcast resource properties that the API response will include. The part
-        #   names that you can include in the parameter value are id, snippet,
-        #   contentDetails, and status.
+        #   Broadcast to transition.
+        # @param [String] broadcast_status
+        #   The status to which the broadcast is going to transition.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>liveBroadcast</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, <code>contentDetails</code>, and <code>status</code>.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1941,8 +1803,8 @@ module Google
         # @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 transition_live_broadcast(broadcast_status, id, part, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveBroadcasts/transition', options)
+        def transition_live_broadcast(id, broadcast_status, part, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveBroadcasts/transition', options)
           command.response_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
           command.response_class = Google::Apis::YoutubeV3::LiveBroadcast
           command.query['broadcastStatus'] = broadcast_status unless broadcast_status.nil?
@@ -1952,60 +1814,66 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a broadcast. For example, you could modify the broadcast settings
-        # defined in the liveBroadcast resource's contentDetails object.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part properties that you can include in the parameter value are id,
-        #   snippet, contentDetails, and status.
-        #   Note that this method will override the existing values for all of the mutable
-        #   properties that are contained in any parts that the parameter value specifies.
-        #   For example, a broadcast's privacy status is defined in the status part. As
+        # Updates an existing broadcast for the authenticated user.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br><br>The <code>part</code> properties that you can include in
+        #   the parameter value are <code>id</code>, <code>snippet</code>,
+        #   <code>contentDetails</code>, and <code>status</code>.<br><br>Note that this
+        #   method will override the existing values for all of the mutable properties
+        #   that are contained in any parts that the parameter value specifies. For
+        #   example, a
+        #   broadcast's privacy status is defined in the <code>status</code> part. As
         #   such, if your request is updating a private or unlisted broadcast, and the
-        #   request's part parameter value includes the status part, the broadcast's
-        #   privacy setting will be updated to whatever value the request body specifies.
-        #   If the request body does not specify a value, the existing privacy setting
-        #   will be removed and the broadcast will revert to the default privacy setting.
+        #   request's <code>part</code> parameter value includes the
+        #   <code>status</code> part, the broadcast's privacy setting will be updated
+        #   to whatever value the request body specifies. If the request body does not
+        #   specify a value, the existing privacy setting will be removed and the
+        #   broadcast will revert to the default privacy setting.
         # @param [Google::Apis::YoutubeV3::LiveBroadcast] live_broadcast_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2018,8 +1886,8 @@ module Google
         # @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 update_live_broadcast(part, live_broadcast_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'liveBroadcasts', options)
+        def update_live_broadcast(part, live_broadcast_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/liveBroadcasts', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
           command.request_object = live_broadcast_object
           command.response_representation = Google::Apis::YoutubeV3::LiveBroadcast::Representation
@@ -2029,21 +1897,16 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Removes a chat ban.
+        # Deletes a chat ban.
         # @param [String] id
-        #   The id parameter identifies the chat ban to remove. The value uniquely
-        #   identifies both the ban and the chat.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2056,28 +1919,26 @@ module Google
         # @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 delete_live_chat_ban(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'liveChat/bans', options)
+        def delete_live_chat_ban(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/liveChat/bans', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a new ban to the chat.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response returns. Set the parameter value to snippet.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response returns. Set the
+        #   parameter value to <code>snippet</code>.
         # @param [Google::Apis::YoutubeV3::LiveChatBan] live_chat_ban_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2090,8 +1951,8 @@ module Google
         # @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 insert_live_chat_ban(part, live_chat_ban_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveChat/bans', options)
+        def insert_live_chat_ban(part, live_chat_ban_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveChat/bans', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveChatBan::Representation
           command.request_object = live_chat_ban_object
           command.response_representation = Google::Apis::YoutubeV3::LiveChatBan::Representation
@@ -2099,21 +1960,16 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Deletes a chat message.
         # @param [String] id
-        #   The id parameter specifies the YouTube chat message ID of the resource that is
-        #   being deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2126,28 +1982,26 @@ module Google
         # @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 delete_live_chat_message(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'liveChat/messages', options)
+        def delete_live_chat_message(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/liveChat/messages', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a message to a live chat.
-        # @param [String] part
-        #   The part parameter serves two purposes. It identifies the properties that the
-        #   write operation will set as well as the properties that the API response will
-        #   include. Set the parameter value to snippet.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes. It
+        #   identifies the properties that the write operation will set as well as the
+        #   properties that the API response will include. Set the parameter value to
+        #   <code>snippet</code>.
         # @param [Google::Apis::YoutubeV3::LiveChatMessage] live_chat_message_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2160,8 +2014,8 @@ module Google
         # @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 insert_live_chat_message(part, live_chat_message_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveChat/messages', options)
+        def insert_live_chat_message(part, live_chat_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveChat/messages', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveChatMessage::Representation
           command.request_object = live_chat_message_object
           command.response_representation = Google::Apis::YoutubeV3::LiveChatMessage::Representation
@@ -2169,43 +2023,35 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists live chat messages for a specific chat.
+        # Retrieves a list of resources, possibly filtered.
         # @param [String] live_chat_id
-        #   The liveChatId parameter specifies the ID of the chat whose messages will be
-        #   returned.
-        # @param [String] part
-        #   The part parameter specifies the liveChatComment resource parts that the API
-        #   response will include. Supported values are id and snippet.
+        #   The id of the live chat for which comments should be returned.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>liveChatComment</code> resource parts that the API response will
+        #   include. Supported values are <code>id</code> and <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter instructs the API to retrieve localized resource metadata for
-        #   a specific application language that the YouTube website supports. The
-        #   parameter value must be a language code included in the list returned by the
-        #   i18nLanguages.list method.
-        #   If localized resource details are available in that language, the resource's
-        #   snippet.localized object will contain the localized values. However, if
-        #   localized details are not available, the snippet.localized object will contain
-        #   resource details in the resource's default language.
+        #   Specifies the localization language in which the system messages
+        #   should be returned.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of messages that should
-        #   be returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken property identify
-        #   other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> property identify other pages that could be
+        #   retrieved.
         # @param [Fixnum] profile_image_size
-        #   The profileImageSize parameter specifies the size of the user profile pictures
-        #   that should be returned in the result set. Default: 88.
+        #   Specifies the size of the profile image that should be
+        #   returned for each user.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2218,8 +2064,8 @@ module Google
         # @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_live_chat_messages(live_chat_id, part, hl: nil, max_results: nil, page_token: nil, profile_image_size: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'liveChat/messages', options)
+        def list_live_chat_messages(live_chat_id, part, hl: nil, max_results: nil, page_token: nil, profile_image_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/liveChat/messages', options)
           command.response_representation = Google::Apis::YoutubeV3::LiveChatMessageListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::LiveChatMessageListResponse
           command.query['hl'] = hl unless hl.nil?
@@ -2230,21 +2076,16 @@ module Google
           command.query['profileImageSize'] = profile_image_size unless profile_image_size.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Removes a chat moderator.
+        # Deletes a chat moderator.
         # @param [String] id
-        #   The id parameter identifies the chat moderator to remove. The value uniquely
-        #   identifies both the moderator and the chat.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2257,28 +2098,26 @@ module Google
         # @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 delete_live_chat_moderator(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'liveChat/moderators', options)
+        def delete_live_chat_moderator(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/liveChat/moderators', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a new moderator for the chat.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response returns. Set the parameter value to snippet.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response returns. Set the
+        #   parameter value to <code>snippet</code>.
         # @param [Google::Apis::YoutubeV3::LiveChatModerator] live_chat_moderator_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2291,8 +2130,8 @@ module Google
         # @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 insert_live_chat_moderator(part, live_chat_moderator_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveChat/moderators', options)
+        def insert_live_chat_moderator(part, live_chat_moderator_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveChat/moderators', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveChatModerator::Representation
           command.request_object = live_chat_moderator_object
           command.response_representation = Google::Apis::YoutubeV3::LiveChatModerator::Representation
@@ -2300,31 +2139,29 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists moderators for a live chat.
+        # Retrieves a list of resources, possibly filtered.
         # @param [String] live_chat_id
-        #   The liveChatId parameter specifies the YouTube live chat for which the API
-        #   should return moderators.
-        # @param [String] part
-        #   The part parameter specifies the liveChatModerator resource parts that the API
-        #   response will include. Supported values are id and snippet.
+        #   The id of the live chat for which moderators should be returned.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>liveChatModerator</code> resource parts that the API response will
+        #   include. Supported values are <code>id</code> and <code>snippet</code>.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2337,8 +2174,8 @@ module Google
         # @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_live_chat_moderators(live_chat_id, part, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'liveChat/moderators', options)
+        def list_live_chat_moderators(live_chat_id, part, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/liveChat/moderators', options)
           command.response_representation = Google::Apis::YoutubeV3::LiveChatModeratorListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::LiveChatModeratorListResponse
           command.query['liveChatId'] = live_chat_id unless live_chat_id.nil?
@@ -2347,47 +2184,49 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a video stream.
+        # Deletes an existing stream for the authenticated user.
         # @param [String] id
-        #   The id parameter specifies the YouTube live stream ID for the resource that is
-        #   being deleted.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2400,59 +2239,63 @@ module Google
         # @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 delete_live_stream(id, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'liveStreams', options)
+        def delete_live_stream(id, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/liveStreams', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['onBehalfOfContentOwnerChannel'] = on_behalf_of_content_owner_channel unless on_behalf_of_content_owner_channel.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a video stream. The stream enables you to send your video to YouTube,
-        # which can then broadcast the video to your audience.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part properties that you can include in the parameter value are id,
-        #   snippet, cdn, and status.
+        # Inserts a new stream for the authenticated user.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br><br>The <code>part</code> properties that you can include in
+        #   the parameter value are <code>id</code>, <code>snippet</code>,
+        #   <code>cdn</code>, and <code>status</code>.
         # @param [Google::Apis::YoutubeV3::LiveStream] live_stream_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2465,8 +2308,8 @@ module Google
         # @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 insert_live_stream(part, live_stream_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'liveStreams', options)
+        def insert_live_stream(part, live_stream_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/liveStreams', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveStream::Representation
           command.request_object = live_stream_object
           command.response_representation = Google::Apis::YoutubeV3::LiveStream::Representation
@@ -2476,63 +2319,65 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of video streams that match the API request parameters.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more liveStream
-        #   resource properties that the API response will include. The part names that
-        #   you can include in the parameter value are id, snippet, cdn, and status.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of YouTube stream IDs that
-        #   identify the streams being retrieved. In a liveStream resource, the id
-        #   property specifies the stream's ID.
+        # Retrieve the list of streams associated with the given channel. --
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>liveStream</code> resource
+        #   properties that the API response will include. The <code>part</code> names
+        #   that you can include in the parameter value are <code>id</code>,
+        #   <code>snippet</code>, <code>cdn</code>, and <code>status</code>.
+        # @param [Array<String>, String] id
+        #   Return LiveStreams with the given ids from Stubby or Apiary.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   The mine parameter can be used to instruct the API to only return streams
-        #   owned by the authenticated user. Set the parameter value to true to only
-        #   retrieve your own streams.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2545,8 +2390,8 @@ module Google
         # @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_live_streams(part, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'liveStreams', options)
+        def list_live_streams(part, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/liveStreams', options)
           command.response_representation = Google::Apis::YoutubeV3::ListLiveStreamsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListLiveStreamsResponse
           command.query['id'] = id unless id.nil?
@@ -2558,56 +2403,60 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a video stream. If the properties that you want to change cannot be
-        # updated, then you need to create a new stream with the proper settings.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   The part properties that you can include in the parameter value are id,
-        #   snippet, cdn, and status.
-        #   Note that this method will override the existing values for all of the mutable
-        #   properties that are contained in any parts that the parameter value specifies.
-        #   If the request body does not specify a value for a mutable property, the
-        #   existing value for that property will be removed.
+        # Updates an existing stream for the authenticated user.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br><br>The <code>part</code> properties that you can include in
+        #   the parameter value are <code>id</code>, <code>snippet</code>,
+        #   <code>cdn</code>, and <code>status</code>.<br><br>Note that this method
+        #   will override the existing values for all of the mutable properties that
+        #   are contained in any parts that the parameter value specifies. If the
+        #   request body does not specify a value for a mutable property, the existing
+        #   value for that property will be removed.
         # @param [Google::Apis::YoutubeV3::LiveStream] live_stream_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2620,8 +2469,8 @@ module Google
         # @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 update_live_stream(part, live_stream_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'liveStreams', options)
+        def update_live_stream(part, live_stream_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/liveStreams', options)
           command.request_representation = Google::Apis::YoutubeV3::LiveStream::Representation
           command.request_object = live_stream_object
           command.response_representation = Google::Apis::YoutubeV3::LiveStream::Representation
@@ -2631,39 +2480,34 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists members for a channel.
-        # @param [String] part
-        #   The part parameter specifies the member resource parts that the API response
-        #   will include. Set the parameter value to snippet.
+        # Retrieves a list of members that match the request criteria for a channel.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>member</code> resource parts that the API response will include. Set
+        #   the parameter value to <code>snippet</code>.
         # @param [String] filter_by_member_channel_id
-        #   The filterByMemberChannelId parameter represents a comma separated list of
-        #   channel IDs. Only data about members that are part of this list will be
-        #   included in the response. It can be used to efficiently check whether specific
-        #   users are entitled to perks offered via third parties.
+        #   Comma separated list of channel IDs. Only data about members that are part
+        #   of this list will be included in the response.
         # @param [String] has_access_to_level
-        #   The hasAccessToLevel parameter specifies, when set, the ID of a pricing level
-        #   that members from the results set should have access to. When not set, all
-        #   members will be considered, regardless of their active pricing level.
+        #   Filter members in the results set to the ones that have access to a level.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] mode
-        #   The mode parameter specifies which channel members to return.
+        #   Parameter that specifies which channel members to return.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2676,8 +2520,8 @@ module Google
         # @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_members(part, filter_by_member_channel_id: nil, has_access_to_level: nil, max_results: nil, mode: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'members', options)
+        def list_members(part, filter_by_member_channel_id: nil, has_access_to_level: nil, max_results: nil, mode: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/members', options)
           command.response_representation = Google::Apis::YoutubeV3::MemberListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::MemberListResponse
           command.query['filterByMemberChannelId'] = filter_by_member_channel_id unless filter_by_member_channel_id.nil?
@@ -2688,21 +2532,19 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists pricing levels for a channel.
-        # @param [String] part
-        #   The part parameter specifies the membershipsLevel resource parts that the API
-        #   response will include. Supported values are id and snippet.
+        # Retrieves a list of all pricing levels offered by a creator to the fans.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>membershipsLevel</code> resource parts that the API response will
+        #   include. Supported values are <code>id</code> and <code>snippet</code>.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2715,39 +2557,36 @@ module Google
         # @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_memberships_levels(part, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'membershipsLevels', options)
+        def list_memberships_levels(part, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/membershipsLevels', options)
           command.response_representation = Google::Apis::YoutubeV3::MembershipsLevelListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::MembershipsLevelListResponse
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a playlist item.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the YouTube playlist item ID for the playlist item
-        #   that is being deleted. In a playlistItem resource, the id property specifies
-        #   the playlist item's ID.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2760,39 +2599,39 @@ module Google
         # @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 delete_playlist_item(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'playlistItems', options)
+        def delete_playlist_item(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/playlistItems', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a resource to a playlist.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will include.
         # @param [Google::Apis::YoutubeV3::PlaylistItem] playlist_item_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2805,8 +2644,8 @@ module Google
         # @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 insert_playlist_item(part, playlist_item_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'playlistItems', options)
+        def insert_playlist_item(part, playlist_item_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/playlistItems', options)
           command.request_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
           command.request_object = playlist_item_object
           command.response_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
@@ -2815,57 +2654,53 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a collection of playlist items that match the API request parameters.
-        # You can retrieve all of the playlist items in a specified playlist or retrieve
-        # one or more playlist items by their unique IDs.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   playlistItem resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a
-        #   playlistItem resource, the snippet property contains numerous fields,
-        #   including the title, description, position, and resourceId properties. As such,
-        #   if you set part=snippet, the API response will contain all of those
-        #   properties.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of one or more unique
-        #   playlist item IDs.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>playlistItem</code> resource
+        #   properties that the API response will include.<br><br>If the parameter
+        #   identifies a property that contains child properties, the child properties
+        #   will be included in the response. For example, in a
+        #   <code>playlistItem</code> resource, the <code>snippet</code> property
+        #   contains numerous fields, including the <code>title</code>,
+        #   <code>description</code>, <code>position</code>, and
+        #   <code>resourceId</code> properties. As such, if you set
+        #   <code><strong>part=snippet</strong></code>, the API response will contain
+        #   all of those properties.
+        # @param [Array<String>, String] id
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] playlist_id
-        #   The playlistId parameter specifies the unique ID of the playlist for which you
-        #   want to retrieve playlist items. Note that even though this is an optional
-        #   parameter, every request to retrieve playlist items must specify a value for
-        #   either the id parameter or the playlistId parameter.
+        #   Return the playlist items within the given playlist.
         # @param [String] video_id
-        #   The videoId parameter specifies that the request should return only the
-        #   playlist items that contain the specified video.
+        #   Return the playlist items associated with the given video ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2878,8 +2713,8 @@ module Google
         # @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_playlist_items(part, id: nil, max_results: nil, on_behalf_of_content_owner: nil, page_token: nil, playlist_id: nil, video_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'playlistItems', options)
+        def list_playlist_items(part, id: nil, max_results: nil, on_behalf_of_content_owner: nil, page_token: nil, playlist_id: nil, video_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/playlistItems', options)
           command.response_representation = Google::Apis::YoutubeV3::ListPlaylistItemsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListPlaylistItemsResponse
           command.query['id'] = id unless id.nil?
@@ -2891,44 +2726,44 @@ module Google
           command.query['videoId'] = video_id unless video_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies a playlist item. For example, you could update the item's position in
-        # the playlist.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   Note that this method will override the existing values for all of the mutable
-        #   properties that are contained in any parts that the parameter value specifies.
-        #   For example, a playlist item can specify a start time and end time, which
-        #   identify the times portion of the video that should play when users watch the
-        #   video in the playlist. If your request is updating a playlist item that sets
-        #   these values, and the request's part parameter value includes the
-        #   contentDetails part, the playlist item's start and end times will be updated
-        #   to whatever value the request body specifies. If the request body does not
-        #   specify values, the existing start and end times will be removed and replaced
-        #   with the default settings.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>Note that this method will override the existing values
+        #   for all of the mutable properties that are contained in any parts that the
+        #   parameter value specifies. For example, a playlist item can specify a start
+        #   time and end time, which identify the times portion of the video that
+        #   should play when users watch the video in the playlist. If your request is
+        #   updating a playlist item that sets these values, and the
+        #   request's <code>part</code> parameter value includes the
+        #   <code>contentDetails</code> part, the playlist item's start and end times
+        #   will be updated to whatever value the request body specifies. If the
+        #   request body does not specify values, the existing start and end times will
+        #   be removed and replaced with the default settings.
         # @param [Google::Apis::YoutubeV3::PlaylistItem] playlist_item_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2941,8 +2776,8 @@ module Google
         # @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 update_playlist_item(part, playlist_item_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'playlistItems', options)
+        def update_playlist_item(part, playlist_item_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/playlistItems', options)
           command.request_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
           command.request_object = playlist_item_object
           command.response_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
@@ -2951,32 +2786,29 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a playlist.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the YouTube playlist ID for the playlist that is
-        #   being deleted. In a playlist resource, the id property specifies the playlist'
-        #   s ID.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -2989,55 +2821,59 @@ module Google
         # @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 delete_playlist(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'playlists', options)
+        def delete_playlist(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/playlists', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a playlist.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will include.
         # @param [Google::Apis::YoutubeV3::Playlist] playlist_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3050,8 +2886,8 @@ module Google
         # @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 insert_playlist(part, playlist_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'playlists', options)
+        def insert_playlist(part, playlist_object = nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/playlists', options)
           command.request_representation = Google::Apis::YoutubeV3::Playlist::Representation
           command.request_object = playlist_object
           command.response_representation = Google::Apis::YoutubeV3::Playlist::Representation
@@ -3061,74 +2897,75 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a collection of playlists that match the API request parameters. For
-        # example, you can retrieve all playlists that the authenticated user owns, or
-        # you can retrieve one or more playlists by their unique IDs.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more playlist
-        #   resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a playlist
-        #   resource, the snippet property contains properties like author, title,
-        #   description, tags, and timeCreated. As such, if you set part=snippet, the API
-        #   response will contain all of those properties.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>playlist</code> resource
+        #   properties that the API response will include.<br><br>If the parameter
+        #   identifies a property that contains child properties, the child properties
+        #   will be included in the response. For example, in a <code>playlist</code>
+        #   resource, the <code>snippet</code> property contains properties like
+        #   <code>author</code>, <code>title</code>, <code>description</code>,
+        #   <code>tags</code>, and <code>timeCreated</code>. As such, if you set
+        #   <code><strong>part=snippet</strong></code>, the API response will contain
+        #   all of those properties.
         # @param [String] channel_id
-        #   This value indicates that the API should only return the specified channel's
-        #   playlists.
+        #   Return the playlists owned by the specified channel ID.
         # @param [String] hl
-        #   The hl parameter should be used for filter out the properties that are not in
-        #   the given language. Used for the snippet part.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube playlist ID(s)
-        #   for the resource(s) that are being retrieved. In a playlist resource, the id
-        #   property specifies the playlist's YouTube playlist ID.
+        #   Returen content in specified language
+        # @param [Array<String>, String] id
+        #   Return the playlists with the given IDs for Stubby or Apiary.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   Set this parameter's value to true to instruct the API to only return
-        #   playlists owned by the authenticated user.
+        #   Return the playlists owned by the authenticated user.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3141,8 +2978,8 @@ module Google
         # @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_playlists(part, channel_id: nil, hl: nil, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'playlists', options)
+        def list_playlists(part, channel_id: nil, hl: nil, id: nil, max_results: nil, mine: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/playlists', options)
           command.response_representation = Google::Apis::YoutubeV3::ListPlaylistResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListPlaylistResponse
           command.query['channelId'] = channel_id unless channel_id.nil?
@@ -3156,40 +2993,40 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies a playlist. For example, you could change a playlist's title,
-        # description, or privacy status.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   Note that this method will override the existing values for mutable properties
-        #   that are contained in any parts that the request body specifies. For example,
-        #   a playlist's description is contained in the snippet part, which must be
-        #   included in the request body. If the request does not specify a value for the
-        #   snippet.description property, the playlist's existing description will be
-        #   deleted.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>Note that this method will override the existing values
+        #   for mutable properties that are contained in any parts that the request
+        #   body specifies. For example, a
+        #   playlist's description is contained in the <code>snippet</code> part, which
+        #   must be included in the request body. If the request does not specify a
+        #   value for the <code>snippet.description</code> property, the playlist's
+        #   existing description will be deleted.
         # @param [Google::Apis::YoutubeV3::Playlist] playlist_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3202,8 +3039,8 @@ module Google
         # @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 update_playlist(part, playlist_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'playlists', options)
+        def update_playlist(part, playlist_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/playlists', options)
           command.request_representation = Google::Apis::YoutubeV3::Playlist::Representation
           command.request_object = playlist_object
           command.response_representation = Google::Apis::YoutubeV3::Playlist::Representation
@@ -3212,174 +3049,97 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a collection of search results that match the query parameters
-        # specified in the API request. By default, a search result set identifies
-        # matching video, channel, and playlist resources, but you can also configure
-        # queries to only retrieve a specific type of resource.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more search
-        #   resource properties that the API response will include. Set the parameter
-        #   value to snippet.
+        # Retrieves a list of search resources
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>search</code> resource properties
+        #   that the API response will include. Set the parameter value to
+        #   <code>snippet</code>.
         # @param [String] channel_id
-        #   The channelId parameter indicates that the API response should only contain
-        #   resources created by the channel
+        #   Filter on resources belonging to this channelId.
         # @param [String] channel_type
-        #   The channelType parameter lets you restrict a search to a particular type of
-        #   channel.
+        #   Add a filter on the channel search.
         # @param [String] event_type
-        #   The eventType parameter restricts a search to broadcast events. If you specify
-        #   a value for this parameter, you must also set the type parameter's value to
-        #   video.
+        #   Filter on the livestream status of the videos.
         # @param [Boolean] for_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The forContentOwner parameter restricts the search to only retrieve resources
-        #   owned by the content owner specified by the onBehalfOfContentOwner parameter.
-        #   The user must be authenticated using a CMS account linked to the specified
-        #   content owner and onBehalfOfContentOwner must be provided.
+        #   Search owned by a content owner.
         # @param [Boolean] for_developer
-        #   The forDeveloper parameter restricts the search to only retrieve videos
-        #   uploaded via the developer's application or website. The API server uses the
-        #   request's authorization credentials to identify the developer. Therefore, a
-        #   developer can restrict results to videos uploaded through the developer's own
-        #   app or website but not to videos uploaded through other apps or sites.
+        #   Restrict the search to only retrieve videos uploaded using the project id
+        #   of the authenticated user.
         # @param [Boolean] for_mine
-        #   The forMine parameter restricts the search to only retrieve videos owned by
-        #   the authenticated user. If you set this parameter to true, then the type
-        #   parameter's value must also be set to video.
+        #   Search for the private videos of the authenticated user.
         # @param [String] location
-        #   The location parameter, in conjunction with the locationRadius parameter,
-        #   defines a circular geographic area and also restricts a search to videos that
-        #   specify, in their metadata, a geographic location that falls within that area.
-        #   The parameter value is a string that specifies latitude/longitude coordinates
-        #   e.g. (37.42307,-122.08427).
-        #   - The location parameter value identifies the point at the center of the area.
-        #   - The locationRadius parameter specifies the maximum distance that the
-        #   location associated with a video can be from that point for the video to still
-        #   be included in the search results.The API returns an error if your request
-        #   specifies a value for the location parameter but does not also specify a value
-        #   for the locationRadius parameter.
+        #   Filter on location of the video
         # @param [String] location_radius
-        #   The locationRadius parameter, in conjunction with the location parameter,
-        #   defines a circular geographic area.
-        #   The parameter value must be a floating point number followed by a measurement
-        #   unit. Valid measurement units are m, km, ft, and mi. For example, valid
-        #   parameter values include 1500m, 5km, 10000ft, and 0.75mi. The API does not
-        #   support locationRadius parameter values larger than 1000 kilometers.
-        #   Note: See the definition of the location parameter for more information.
+        #   Filter on distance from the location (specified above).
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] order
-        #   The order parameter specifies the method that will be used to order resources
-        #   in the API response.
+        #   Sort order of the results.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
-        # @param [DateTime] published_after
-        #   The publishedAfter parameter indicates that the API response should only
-        #   contain resources created after the specified time. The value is an RFC 3339
-        #   formatted date-time value (1970-01-01T00:00:00Z).
-        # @param [DateTime] published_before
-        #   The publishedBefore parameter indicates that the API response should only
-        #   contain resources created before the specified time. The value is an RFC 3339
-        #   formatted date-time value (1970-01-01T00:00:00Z).
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
+        # @param [String] published_after
+        #   Filter on resources published after this date.
+        # @param [String] published_before
+        #   Filter on resources published before this date.
         # @param [String] q
-        #   The q parameter specifies the query term to search for.
-        #   Your request can also use the Boolean NOT (-) and OR (|) operators to exclude
-        #   videos or to find videos that are associated with one of several search terms.
-        #   For example, to search for videos matching either "boating" or "sailing", set
-        #   the q parameter value to boating|sailing. Similarly, to search for videos
-        #   matching either "boating" or "sailing" but not "fishing", set the q parameter
-        #   value to boating|sailing -fishing. Note that the pipe character must be URL-
-        #   escaped when it is sent in your API request. The URL-escaped value for the
-        #   pipe character is %7C.
+        #   Textual search terms to match.
         # @param [String] region_code
-        #   The regionCode parameter instructs the API to return search results for the
-        #   specified country. The parameter value is an ISO 3166-1 alpha-2 country code.
+        #   Display the content as seen by viewers in this country.
         # @param [String] related_to_video_id
-        #   The relatedToVideoId parameter retrieves a list of videos that are related to
-        #   the video that the parameter value identifies. The parameter value must be set
-        #   to a YouTube video ID and, if you are using this parameter, the type parameter
-        #   must be set to video.
+        #   Search related to a resource.
         # @param [String] relevance_language
-        #   The relevanceLanguage parameter instructs the API to return search results
-        #   that are most relevant to the specified language. The parameter value is
-        #   typically an ISO 639-1 two-letter language code. However, you should use the
-        #   values zh-Hans for simplified Chinese and zh-Hant for traditional Chinese.
-        #   Please note that results in other languages will still be returned if they are
-        #   highly relevant to the search query term.
+        #   Return results relevant to this language.
         # @param [String] safe_search
-        #   The safeSearch parameter indicates whether the search results should include
-        #   restricted content as well as standard content.
+        #   Indicates whether the search results should include restricted content as
+        #   well as standard content.
         # @param [String] topic_id
-        #   The topicId parameter indicates that the API response should only contain
-        #   resources associated with the specified topic. The value identifies a Freebase
-        #   topic ID.
-        # @param [String] type
-        #   The type parameter restricts a search query to only retrieve a particular type
-        #   of resource. The value is a comma-separated list of resource types.
+        #   Restrict results to a particular topic.
+        # @param [Array<String>, String] type
+        #   Restrict results to a particular set of resource types from One Platform.
         # @param [String] video_caption
-        #   The videoCaption parameter indicates whether the API should filter video
-        #   search results based on whether they have captions. If you specify a value for
-        #   this parameter, you must also set the type parameter's value to video.
+        #   Filter on the presence of captions on the videos.
         # @param [String] video_category_id
-        #   The videoCategoryId parameter filters video search results based on their
-        #   category. If you specify a value for this parameter, you must also set the
-        #   type parameter's value to video.
+        #   Filter on videos in a specific category.
         # @param [String] video_definition
-        #   The videoDefinition parameter lets you restrict a search to only include
-        #   either high definition (HD) or standard definition (SD) videos. HD videos are
-        #   available for playback in at least 720p, though higher resolutions, like 1080p,
-        #   might also be available. If you specify a value for this parameter, you must
-        #   also set the type parameter's value to video.
+        #   Filter on the definition of the videos.
         # @param [String] video_dimension
-        #   The videoDimension parameter lets you restrict a search to only retrieve 2D or
-        #   3D videos. If you specify a value for this parameter, you must also set the
-        #   type parameter's value to video.
+        #   Filter on 3d videos.
         # @param [String] video_duration
-        #   The videoDuration parameter filters video search results based on their
-        #   duration. If you specify a value for this parameter, you must also set the
-        #   type parameter's value to video.
+        #   Filter on the duration of the videos.
         # @param [String] video_embeddable
-        #   The videoEmbeddable parameter lets you to restrict a search to only videos
-        #   that can be embedded into a webpage. If you specify a value for this parameter,
-        #   you must also set the type parameter's value to video.
+        #   Filter on embeddable videos.
         # @param [String] video_license
-        #   The videoLicense parameter filters search results to only include videos with
-        #   a particular license. YouTube lets video uploaders choose to attach either the
-        #   Creative Commons license or the standard YouTube license to each of their
-        #   videos. If you specify a value for this parameter, you must also set the type
-        #   parameter's value to video.
+        #   Filter on the license of the videos.
         # @param [String] video_syndicated
-        #   The videoSyndicated parameter lets you to restrict a search to only videos
-        #   that can be played outside youtube.com. If you specify a value for this
-        #   parameter, you must also set the type parameter's value to video.
+        #   Filter on syndicated videos.
         # @param [String] video_type
-        #   The videoType parameter lets you restrict a search to a particular type of
-        #   videos. If you specify a value for this parameter, you must also set the type
-        #   parameter's value to video.
+        #   Filter on videos of a specific type.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3392,8 +3152,8 @@ module Google
         # @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_searches(part, channel_id: nil, channel_type: nil, event_type: nil, for_content_owner: nil, for_developer: nil, for_mine: nil, location: nil, location_radius: nil, max_results: nil, on_behalf_of_content_owner: nil, order: nil, page_token: nil, published_after: nil, published_before: nil, q: nil, region_code: nil, related_to_video_id: nil, relevance_language: nil, safe_search: nil, topic_id: nil, type: nil, video_caption: nil, video_category_id: nil, video_definition: nil, video_dimension: nil, video_duration: nil, video_embeddable: nil, video_license: nil, video_syndicated: nil, video_type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'search', options)
+        def list_searches(part, channel_id: nil, channel_type: nil, event_type: nil, for_content_owner: nil, for_developer: nil, for_mine: nil, location: nil, location_radius: nil, max_results: nil, on_behalf_of_content_owner: nil, order: nil, page_token: nil, published_after: nil, published_before: nil, q: nil, region_code: nil, related_to_video_id: nil, relevance_language: nil, safe_search: nil, topic_id: nil, type: nil, video_caption: nil, video_category_id: nil, video_definition: nil, video_dimension: nil, video_duration: nil, video_embeddable: nil, video_license: nil, video_syndicated: nil, video_type: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/search', options)
           command.response_representation = Google::Apis::YoutubeV3::SearchListsResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::SearchListsResponse
           command.query['channelId'] = channel_id unless channel_id.nil?
@@ -3429,30 +3189,30 @@ module Google
           command.query['videoType'] = video_type unless video_type.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists sponsors for a channel.
-        # @param [String] part
-        #   The part parameter specifies the sponsor resource parts that the API response
-        #   will include. Supported values are id and snippet.
+        # Retrieves a list of sponsors that match the request criteria for a
+        # channel.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>sponsor</code> resource parts that the API response will include.
+        #   Supported values are <code>id</code> and <code>snippet</code>.
         # @param [String] filter
-        #   The filter parameter specifies which channel sponsors to return.
+        #   Parameter that specifies which channel sponsors to return.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3465,8 +3225,8 @@ module Google
         # @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_sponsors(part, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'sponsors', options)
+        def list_sponsors(part, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/sponsors', options)
           command.response_representation = Google::Apis::YoutubeV3::SponsorListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::SponsorListResponse
           command.query['filter'] = filter unless filter.nil?
@@ -3475,22 +3235,16 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a subscription.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the YouTube subscription ID for the resource that
-        #   is being deleted. In a subscription resource, the id property specifies the
-        #   YouTube subscription ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3503,28 +3257,25 @@ module Google
         # @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 delete_subscription(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'subscriptions', options)
+        def delete_subscription(id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/subscriptions', options)
           command.query['id'] = id unless id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a subscription for the authenticated user's channel.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will include.
         # @param [Google::Apis::YoutubeV3::Subscription] subscription_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3537,8 +3288,8 @@ module Google
         # @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 insert_subscription(part, subscription_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'subscriptions', options)
+        def insert_subscription(part, subscription_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/subscriptions', options)
           command.request_representation = Google::Apis::YoutubeV3::Subscription::Representation
           command.request_object = subscription_object
           command.response_representation = Google::Apis::YoutubeV3::Subscription::Representation
@@ -3546,81 +3297,80 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns subscription resources that match the API request criteria.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more
-        #   subscription resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a
-        #   subscription resource, the snippet property contains other properties, such as
-        #   a display title for the subscription. If you set part=snippet, the API
-        #   response will also contain all of those nested properties.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>subscription</code> resource
+        #   properties that the API response will include.<br><br>If the parameter
+        #   identifies a property that contains child properties, the child properties
+        #   will be included in the response. For example, in a
+        #   <code>subscription</code> resource, the <code>snippet</code> property
+        #   contains other properties, such as a display title for the subscription. If
+        #   you set <code><strong>part=snippet</strong></code>, the API response will
+        #   also contain all of those nested properties.
         # @param [String] channel_id
-        #   The channelId parameter specifies a YouTube channel ID. The API will only
-        #   return that channel's subscriptions.
+        #   Return the subscriptions of the given channel owner.
         # @param [String] for_channel_id
-        #   The forChannelId parameter specifies a comma-separated list of channel IDs.
-        #   The API response will then only contain subscriptions matching those channels.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube subscription
-        #   ID(s) for the resource(s) that are being retrieved. In a subscription resource,
-        #   the id property specifies the YouTube subscription ID.
+        #   Return the subscriptions to the subset of these channels that the
+        #   authenticated user is subscribed to.
+        # @param [Array<String>, String] id
+        #   Return the subscriptions with the given IDs for Stubby or Apiary.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [Boolean] mine
-        #   Set this parameter's value to true to retrieve a feed of the authenticated
-        #   user's subscriptions.
+        #   Flag for returning the subscriptions of the authenticated user.
         # @param [Boolean] my_recent_subscribers
-        #   Set this parameter's value to true to retrieve a feed of the subscribers of
-        #   the authenticated user in reverse chronological order (newest first).
         # @param [Boolean] my_subscribers
-        #   Set this parameter's value to true to retrieve a feed of the subscribers of
-        #   the authenticated user in no particular order.
+        #   Return the subscribers of the given channel owner.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [String] order
-        #   The order parameter specifies the method that will be used to sort resources
-        #   in the API response.
+        #   The order of the returned subscriptions
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3633,8 +3383,8 @@ module Google
         # @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_subscriptions(part, channel_id: nil, for_channel_id: nil, id: nil, max_results: nil, mine: nil, my_recent_subscribers: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, order: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'subscriptions', options)
+        def list_subscriptions(part, channel_id: nil, for_channel_id: nil, id: nil, max_results: nil, mine: nil, my_recent_subscribers: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, order: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/subscriptions', options)
           command.response_representation = Google::Apis::YoutubeV3::ListSubscriptionResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListSubscriptionResponse
           command.query['channelId'] = channel_id unless channel_id.nil?
@@ -3651,37 +3401,29 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists Super Chat events for a channel.
-        # @param [String] part
-        #   The part parameter specifies the superChatEvent resource parts that the API
-        #   response will include. Supported values are id and snippet.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>superChatEvent</code> resource parts that the API response will
+        #   include. Supported values are <code>id</code> and <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter instructs the API to retrieve localized resource metadata for
-        #   a specific application language that the YouTube website supports. The
-        #   parameter value must be a language code included in the list returned by the
-        #   i18nLanguages.list method.
-        #   If localized resource details are available in that language, the resource's
-        #   snippet.localized object will contain the localized values. However, if
-        #   localized details are not available, the snippet.localized object will contain
-        #   resource details in the resource's default language.
+        #   Return rendered funding amounts in specified language.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result set.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3694,8 +3436,8 @@ module Google
         # @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_super_chat_events(part, hl: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'superChatEvents', options)
+        def list_super_chat_events(part, hl: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/superChatEvents', options)
           command.response_representation = Google::Apis::YoutubeV3::SuperChatEventListResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::SuperChatEventListResponse
           command.query['hl'] = hl unless hl.nil?
@@ -3704,31 +3446,32 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads a custom video thumbnail to YouTube and sets it for a video.
+        # As this is not an insert in a strict sense (it supports uploading/setting
+        # of a thumbnail for multiple videos, which doesn't result in creation of a
+        # single resource), I use a custom verb here.
         # @param [String] video_id
-        #   The videoId parameter specifies a YouTube video ID for which the custom video
-        #   thumbnail is being provided.
+        #   Returns the Thumbnail with the given video IDs for Stubby or Apiary.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The actual
+        #   CMS account that the user authenticates with must be linked to the
+        #   specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -3745,11 +3488,11 @@ module Google
         # @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 set_thumbnail(video_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def set_thumbnail(video_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:post, 'thumbnails/set', options)
+            command = make_simple_command(:post, 'youtube/v3/thumbnails/set', options)
           else
-            command = make_upload_command(:post, 'thumbnails/set', options)
+            command = make_upload_command(:post, 'youtube/v3/thumbnails/set', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -3759,24 +3502,20 @@ module Google
           command.query['videoId'] = video_id unless video_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of abuse reasons that can be used for reporting abusive videos.
-        # @param [String] part
-        #   The part parameter specifies the videoCategory resource parts that the API
-        #   response will include. Supported values are id and snippet.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>videoCategory</code> resource parts that the API response will
+        #   include. Supported values are <code>id</code> and <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter specifies the language that should be used for text values in
-        #   the API response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3789,39 +3528,31 @@ module Google
         # @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_video_abuse_report_reasons(part, hl: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'videoAbuseReportReasons', options)
+        def list_video_abuse_report_reasons(part, hl: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/videoAbuseReportReasons', options)
           command.response_representation = Google::Apis::YoutubeV3::ListVideoAbuseReportReasonResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListVideoAbuseReportReasonResponse
           command.query['hl'] = hl unless hl.nil?
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of categories that can be associated with YouTube videos.
-        # @param [String] part
-        #   The part parameter specifies the videoCategory resource properties that the
-        #   API response will include. Set the parameter value to snippet.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies the
+        #   <code>videoCategory</code> resource properties that the API response will
+        #   include. Set the parameter value to <code>snippet</code>.
         # @param [String] hl
-        #   The hl parameter specifies the language that should be used for text values in
-        #   the API response.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of video category IDs for
-        #   the resources that you are retrieving.
+        # @param [Array<String>, String] id
+        #   Returns the video categories with the given IDs for Stubby or Apiary.
         # @param [String] region_code
-        #   The regionCode parameter instructs the API to return the list of video
-        #   categories available in the specified country. The parameter value is an ISO
-        #   3166-1 alpha-2 country code.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3834,8 +3565,8 @@ module Google
         # @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_video_categories(part, hl: nil, id: nil, region_code: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'videoCategories', options)
+        def list_video_categories(part, hl: nil, id: nil, region_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/videoCategories', options)
           command.response_representation = Google::Apis::YoutubeV3::ListVideoCategoryResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListVideoCategoryResponse
           command.query['hl'] = hl unless hl.nil?
@@ -3844,31 +3575,29 @@ module Google
           command.query['regionCode'] = region_code unless region_code.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a YouTube video.
+        # Deletes a resource.
         # @param [String] id
-        #   The id parameter specifies the YouTube video ID for the resource that is being
-        #   deleted. In a video resource, the id property specifies the video's ID.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The actual
+        #   CMS account that the user authenticates with must be linked to the
+        #   specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -3881,120 +3610,117 @@ module Google
         # @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 delete_video(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'videos', options)
+        def delete_video(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'youtube/v3/videos', options)
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Retrieves the ratings that the authorized user gave to a list of specified
         # videos.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube video ID(s)
-        #   for the resource(s) for which you are retrieving rating data. In a video
-        #   resource, the id property specifies the video's ID.
+        # @param [Array<String>, String] id
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::YoutubeV3::GetVideoRatingResponse] parsed result object
+        # @yieldparam result [Google::Apis::YoutubeV3::VideoRatingListResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::YoutubeV3::GetVideoRatingResponse]
+        # @return [Google::Apis::YoutubeV3::VideoRatingListResponse]
         #
         # @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_video_rating(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'videos/getRating', options)
-          command.response_representation = Google::Apis::YoutubeV3::GetVideoRatingResponse::Representation
-          command.response_class = Google::Apis::YoutubeV3::GetVideoRatingResponse
+        def get_video_rating(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/videos/getRating', options)
+          command.response_representation = Google::Apis::YoutubeV3::VideoRatingListResponse::Representation
+          command.response_class = Google::Apis::YoutubeV3::VideoRatingListResponse
           command.query['id'] = id unless id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads a video to YouTube and optionally sets the video's metadata.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   Note that not all parts contain properties that can be set when inserting or
-        #   updating a video. For example, the statistics object encapsulates statistics
-        #   that YouTube calculates for a video and does not contain values that you can
-        #   set or modify. If the parameter value specifies a part that does not contain
-        #   mutable values, that part will still be included in the API response.
+        # Inserts a new resource into this collection.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>Note that not all parts contain properties that can be
+        #   set when inserting or updating a video. For example, the
+        #   <code>statistics</code> object encapsulates statistics that YouTube
+        #   calculates for a video and does not contain values that you can set or
+        #   modify. If the parameter value specifies a <code>part</code> that does not
+        #   contain mutable values, that <code>part</code> will still be included in
+        #   the API response.
         # @param [Google::Apis::YoutubeV3::Video] video_object
         # @param [Boolean] auto_levels
-        #   The autoLevels parameter indicates whether YouTube should automatically
-        #   enhance the video's lighting and color.
+        #   Should auto-levels be applied to the upload.
         # @param [Boolean] notify_subscribers
-        #   The notifySubscribers parameter indicates whether YouTube should send a
-        #   notification about the new video to users who subscribe to the video's channel.
-        #   A parameter value of True indicates that subscribers will be notified of
-        #   newly uploaded videos. However, a channel owner who is uploading many videos
-        #   might prefer to set the value to False to avoid sending a notification about
-        #   each new video to the channel's subscribers.
+        #   Notify the channel subscribers about the new video. As default, the
+        #   notification is enabled.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
-        # @param [String] on_behalf_of_content_owner_channel
-        #   This parameter can only be used in a properly authorized request. Note: This
-        #   parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID
-        #   of the channel to which a video is being added. This parameter is required
-        #   when a request specifies a value for the onBehalfOfContentOwner parameter, and
-        #   it can only be used in conjunction with that parameter. In addition, the
-        #   request must be authorized using a CMS account that is linked to the content
-        #   owner that the onBehalfOfContentOwner parameter specifies. Finally, the
-        #   channel that the onBehalfOfContentOwnerChannel parameter value specifies must
-        #   be linked to the content owner that the onBehalfOfContentOwner parameter
-        #   specifies.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
         #   This parameter is intended for YouTube content partners that own and manage
-        #   many different YouTube channels. It allows content owners to authenticate once
-        #   and perform actions on behalf of the channel specified in the parameter value,
-        #   without having to provide authentication credentials for each separate channel.
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
+        # @param [String] on_behalf_of_content_owner_channel
+        #   This parameter can only be used in a properly <a
+        #   href="/youtube/v3/guides/authentication">authorized request</a>.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
+        #   specifies the YouTube channel ID of the channel to which a video is being
+        #   added. This parameter is required when a request specifies a value for the
+        #   <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
+        #   conjunction with that parameter. In addition, the request must be
+        #   authorized using a CMS account that is linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
+        #   channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
+        #   specifies must be linked to the content owner that the
+        #   <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
+        #   parameter is intended for YouTube content partners that own and manage many
+        #   different YouTube channels. It allows content owners to authenticate once
+        #   and perform actions on behalf of the channel specified in the parameter
+        #   value, without having to provide authentication credentials for each
+        #   separate channel.
         # @param [Boolean] stabilize
-        #   The stabilize parameter indicates whether YouTube should adjust the video to
-        #   remove shaky camera motions.
+        #   Should stabilize be applied to the upload.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -4011,11 +3737,11 @@ module Google
         # @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 insert_video(part, video_object = nil, auto_levels: nil, notify_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, stabilize: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def insert_video(part, video_object = nil, auto_levels: nil, notify_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, stabilize: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:post, 'videos', options)
+            command = make_simple_command(:post, 'youtube/v3/videos', options)
           else
-            command = make_upload_command(:post, 'videos', options)
+            command = make_upload_command(:post, 'youtube/v3/videos', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -4031,86 +3757,77 @@ module Google
           command.query['stabilize'] = stabilize unless stabilize.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of videos that match the API request parameters.
-        # @param [String] part
-        #   The part parameter specifies a comma-separated list of one or more video
-        #   resource properties that the API response will include.
-        #   If the parameter identifies a property that contains child properties, the
-        #   child properties will be included in the response. For example, in a video
-        #   resource, the snippet property contains the channelId, title, description,
-        #   tags, and categoryId properties. As such, if you set part=snippet, the API
-        #   response will contain all of those properties.
+        # Retrieves a list of resources, possibly filtered.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter specifies a
+        #   comma-separated list of one or more <code>video</code> resource properties
+        #   that the API response will include.<br><br>If the parameter identifies a
+        #   property that contains child properties, the child properties will be
+        #   included in the response. For example, in a <code>video</code> resource,
+        #   the <code>snippet</code> property contains the <code>channelId</code>,
+        #   <code>title</code>, <code>description</code>, <code>tags</code>, and
+        #   <code>categoryId</code> properties. As such, if you set
+        #   <code><strong>part=snippet</strong></code>, the API response will contain
+        #   all of those properties.
         # @param [String] chart
-        #   The chart parameter identifies the chart that you want to retrieve.
+        #   Return the videos that are in the specified chart.
         # @param [String] hl
-        #   The hl parameter instructs the API to retrieve localized resource metadata for
-        #   a specific application language that the YouTube website supports. The
-        #   parameter value must be a language code included in the list returned by the
-        #   i18nLanguages.list method.
-        #   If localized resource details are available in that language, the resource's
-        #   snippet.localized object will contain the localized values. However, if
-        #   localized details are not available, the snippet.localized object will contain
-        #   resource details in the resource's default language.
-        # @param [String] id
-        #   The id parameter specifies a comma-separated list of the YouTube video ID(s)
-        #   for the resource(s) that are being retrieved. In a video resource, the id
-        #   property specifies the video's ID.
+        #   Stands for "host language". Specifies the localization language of the
+        #   metadata to be filled into snippet.localized. The field is filled with the
+        #   default metadata if there is no localization in the specified language.
+        #   The parameter value must be a language code included in the list returned
+        #   by the i18nLanguages.list method (e.g. en_US, es_MX).
+        # @param [Array<String>, String] id
+        #   Return videos with the given ids.
         # @param [String] locale
-        #   DEPRECATED
         # @param [Fixnum] max_height
-        #   The maxHeight parameter specifies a maximum height of the embedded player. If
-        #   maxWidth is provided, maxHeight may not be reached in order to not violate the
-        #   width request.
         # @param [Fixnum] max_results
-        #   The maxResults parameter specifies the maximum number of items that should be
-        #   returned in the result set.
-        #   Note: This parameter is supported for use in conjunction with the myRating and
-        #   chart parameters, but it is not supported for use in conjunction with the id
+        #   The <code><strong>maxResults</strong></code> parameter specifies the
+        #   maximum number of items that should be returned in the result
+        #   set.<br><br><strong>Note:</strong> This parameter is supported for use in
+        #   conjunction with the <code><a href="#myRating">myRating</a></code> and
+        #   <code><a href="#chart">chart</a></code> parameters, but it is not supported
+        #   for use in conjunction with the <code><a href="#id">id</a></code>
         #   parameter.
         # @param [Fixnum] max_width
-        #   The maxWidth parameter specifies a maximum width of the embedded player. If
-        #   maxHeight is provided, maxWidth may not be reached in order to not violate the
-        #   height request.
+        #   Return the player with maximum height specified in
         # @param [String] my_rating
-        #   Set this parameter's value to like or dislike to instruct the API to only
-        #   return videos liked or disliked by the authenticated user.
+        #   Return videos liked/disliked by the authenticated user.
+        #   Does not support RateType.RATED_TYPE_NONE.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] page_token
-        #   The pageToken parameter identifies a specific page in the result set that
-        #   should be returned. In an API response, the nextPageToken and prevPageToken
-        #   properties identify other pages that could be retrieved.
-        #   Note: This parameter is supported for use in conjunction with the myRating and
-        #   chart parameters, but it is not supported for use in conjunction with the id
-        #   parameter.
+        #   The <code><strong>pageToken</strong></code> parameter identifies a specific
+        #   page in the result set that should be returned. In an API response, the
+        #   <code>nextPageToken</code> and <code>prevPageToken</code> properties
+        #   identify other pages that could be retrieved.<br><br><strong>Note:</strong>
+        #   This parameter is supported for use in conjunction with the <code><a
+        #   href="#myRating">myRating</a></code> and <code><a
+        #   href="#chart">chart</a></code> parameters, but it is not supported for use
+        #   in conjunction with the <code><a href="#id">id</a></code> parameter.
         # @param [String] region_code
-        #   The regionCode parameter instructs the API to select a video chart available
-        #   in the specified region. This parameter can only be used in conjunction with
-        #   the chart parameter. The parameter value is an ISO 3166-1 alpha-2 country code.
+        #   Use a chart that is specific to the specified region
         # @param [String] video_category_id
-        #   The videoCategoryId parameter identifies the video category for which the
-        #   chart should be retrieved. This parameter can only be used in conjunction with
-        #   the chart parameter. By default, charts are not restricted to a particular
-        #   category.
+        #   Use chart that is specific to the specified video category
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -4123,8 +3840,8 @@ module Google
         # @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_videos(part, chart: nil, hl: nil, id: nil, locale: nil, max_height: nil, max_results: nil, max_width: nil, my_rating: nil, on_behalf_of_content_owner: nil, page_token: nil, region_code: nil, video_category_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'videos', options)
+        def list_videos(part, chart: nil, hl: nil, id: nil, locale: nil, max_height: nil, max_results: nil, max_width: nil, my_rating: nil, on_behalf_of_content_owner: nil, page_token: nil, region_code: nil, video_category_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/videos', options)
           command.response_representation = Google::Apis::YoutubeV3::ListVideosResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListVideosResponse
           command.query['chart'] = chart unless chart.nil?
@@ -4142,23 +3859,17 @@ module Google
           command.query['videoCategoryId'] = video_category_id unless video_category_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Add a like or dislike rating to a video or remove a rating from a video.
+        # Adds a like or dislike rating to a video or removes a rating from a video.
         # @param [String] id
-        #   The id parameter specifies the YouTube video ID of the video that is being
-        #   rated or having its rating removed.
         # @param [String] rating
-        #   Specifies the rating to record.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -4171,35 +3882,35 @@ module Google
         # @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 rate_video(id, rating, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'videos/rate', options)
+        def rate_video(id, rating, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/videos/rate', options)
           command.query['id'] = id unless id.nil?
           command.query['rating'] = rating unless rating.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Report abuse for a video.
         # @param [Google::Apis::YoutubeV3::VideoAbuseReport] video_abuse_report_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -4212,54 +3923,57 @@ module Google
         # @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 report_video_abuse(video_abuse_report_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'videos/reportAbuse', options)
+        def report_video_abuse(video_abuse_report_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/videos/reportAbuse', options)
           command.request_representation = Google::Apis::YoutubeV3::VideoAbuseReport::Representation
           command.request_object = video_abuse_report_object
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a video's metadata.
-        # @param [String] part
-        #   The part parameter serves two purposes in this operation. It identifies the
-        #   properties that the write operation will set as well as the properties that
-        #   the API response will include.
-        #   Note that this method will override the existing values for all of the mutable
-        #   properties that are contained in any parts that the parameter value specifies.
-        #   For example, a video's privacy setting is contained in the status part. As
-        #   such, if your request is updating a private video, and the request's part
-        #   parameter value includes the status part, the video's privacy setting will be
-        #   updated to whatever value the request body specifies. If the request body does
-        #   not specify a value, the existing privacy setting will be removed and the
-        #   video will revert to the default privacy setting.
-        #   In addition, not all parts contain properties that can be set when inserting
-        #   or updating a video. For example, the statistics object encapsulates
-        #   statistics that YouTube calculates for a video and does not contain values
-        #   that you can set or modify. If the parameter value specifies a part that does
-        #   not contain mutable values, that part will still be included in the API
-        #   response.
+        # Updates an existing resource.
+        # @param [Array<String>, String] part
+        #   The <code><strong>part</strong></code> parameter serves two purposes in
+        #   this operation. It identifies the properties that the write operation will
+        #   set as well as the properties that the API response will
+        #   include.<br/><br/>Note that this method will override the existing values
+        #   for all of the mutable properties that are contained in any parts that the
+        #   parameter value specifies. For example, a
+        #   video's privacy setting is contained in the <code>status</code> part. As
+        #   such, if your request is updating a private video, and the request's
+        #   <code>part</code> parameter value includes the <code>status</code> part,
+        #   the
+        #   video's privacy setting will be updated to whatever value the request body
+        #   specifies. If the request body does not specify a value, the existing
+        #   privacy setting will be removed and the video will revert to the default
+        #   privacy setting.<br/><br/>In addition, not all parts contain properties
+        #   that can be set when inserting or updating a video. For example, the
+        #   <code>statistics</code> object encapsulates statistics that YouTube
+        #   calculates for a video and does not contain values that you can set or
+        #   modify. If the parameter value specifies a <code>part</code> that does not
+        #   contain mutable values, that <code>part</code> will still be included in
+        #   the API response.
         # @param [Google::Apis::YoutubeV3::Video] video_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The actual CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The actual
+        #   CMS account that the user authenticates with must be linked to the
+        #   specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -4272,8 +3986,8 @@ module Google
         # @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 update_video(part, video_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, 'videos', options)
+        def update_video(part, video_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'youtube/v3/videos', options)
           command.request_representation = Google::Apis::YoutubeV3::Video::Representation
           command.request_object = video_object
           command.response_representation = Google::Apis::YoutubeV3::Video::Representation
@@ -4282,32 +3996,30 @@ module Google
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads a watermark image to YouTube and sets it for a channel.
+        # Allows upload of watermark image and setting it for a channel.
         # @param [String] channel_id
-        #   The channelId parameter specifies the YouTube channel ID for which the
-        #   watermark is being provided.
         # @param [Google::Apis::YoutubeV3::InvideoBranding] invideo_branding_object
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -4324,11 +4036,11 @@ module Google
         # @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 set_watermark(channel_id, invideo_branding_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def set_watermark(channel_id, invideo_branding_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
-            command = make_simple_command(:post, 'watermarks/set', options)
+            command = make_simple_command(:post, 'youtube/v3/watermarks/set', options)
           else
-            command = make_upload_command(:post, 'watermarks/set', options)
+            command = make_upload_command(:post, 'youtube/v3/watermarks/set', options)
             command.upload_source = upload_source
             command.upload_content_type = content_type
           end
@@ -4338,31 +4050,29 @@ module Google
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a channel's watermark image.
+        # Allows removal of channel watermark.
         # @param [String] channel_id
-        #   The channelId parameter specifies the YouTube channel ID for which the
-        #   watermark is being unset.
         # @param [String] on_behalf_of_content_owner
-        #   Note: This parameter is intended exclusively for YouTube content partners.
-        #   The onBehalfOfContentOwner parameter indicates that the request's
-        #   authorization credentials identify a YouTube CMS user who is acting on behalf
-        #   of the content owner specified in the parameter value. This parameter is
-        #   intended for YouTube content partners that own and manage many different
-        #   YouTube channels. It allows content owners to authenticate once and get access
-        #   to all their video and channel data, without having to provide authentication
-        #   credentials for each individual channel. The CMS account that the user
-        #   authenticates with must be linked to the specified YouTube content owner.
+        #   <strong>Note:</strong> This parameter is intended exclusively for YouTube
+        #   content partners.<br><br>The
+        #   <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
+        #   that the
+        #   request's authorization credentials identify a YouTube CMS user who is
+        #   acting on behalf of the content owner specified in the parameter value.
+        #   This parameter is intended for YouTube content partners that own and manage
+        #   many different YouTube channels. It allows content owners to authenticate
+        #   once and get access to all their video and channel data, without having to
+        #   provide authentication credentials for each individual channel. The CMS
+        #   account that the user authenticates with must be linked to the specified
+        #   YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -4375,13 +4085,12 @@ module Google
         # @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 unset_watermark(channel_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'watermarks/unset', options)
+        def unset_watermark(channel_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'youtube/v3/watermarks/unset', options)
           command.query['channelId'] = channel_id unless channel_id.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
 
@@ -4390,7 +4099,6 @@ module Google
         def apply_command_defaults(command)
           command.query['key'] = key unless key.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
         end
       end
     end