google-api-client 0.9.20 → 0.9.21

data/generated/google/apis/bigquery_v2/representations.rb

@@ -490,6 +490,7 @@ module Google
           property :read_ratio_max, as: 'readRatioMax'
           property :records_read, as: 'recordsRead'
           property :records_written, as: 'recordsWritten'
+          property :status, as: 'status'
           collection :steps, as: 'steps', class: Google::Apis::BigqueryV2::ExplainQueryStep, decorator: Google::Apis::BigqueryV2::ExplainQueryStep::Representation
       
           property :wait_ratio_avg, as: 'waitRatioAvg'
@@ -627,6 +628,7 @@ module Google
           property :field_delimiter, as: 'fieldDelimiter'
           property :ignore_unknown_values, as: 'ignoreUnknownValues'
           property :max_bad_records, as: 'maxBadRecords'
+          property :null_marker, as: 'nullMarker'
           collection :projection_fields, as: 'projectionFields'
           property :quote, as: 'quote'
           property :schema, as: 'schema', class: Google::Apis::BigqueryV2::TableSchema, decorator: Google::Apis::BigqueryV2::TableSchema::Representation
@@ -751,6 +753,7 @@ module Google
       
           property :schema, as: 'schema', class: Google::Apis::BigqueryV2::TableSchema, decorator: Google::Apis::BigqueryV2::TableSchema::Representation
       
+          property :statement_type, as: 'statementType'
           property :total_bytes_billed, as: 'totalBytesBilled'
           property :total_bytes_processed, as: 'totalBytesProcessed'
           collection :undeclared_query_parameters, as: 'undeclaredQueryParameters', class: Google::Apis::BigqueryV2::QueryParameter, decorator: Google::Apis::BigqueryV2::QueryParameter::Representation
@@ -921,6 +924,7 @@ module Google
           property :friendly_name, as: 'friendlyName'
           property :id, as: 'id'
           property :kind, as: 'kind'
+          hash :labels, as: 'labels'
           property :last_modified_time, as: 'lastModifiedTime'
           property :location, as: 'location'
           property :num_bytes, as: 'numBytes'
@@ -1027,6 +1031,7 @@ module Google
             property :friendly_name, as: 'friendlyName'
             property :id, as: 'id'
             property :kind, as: 'kind'
+            hash :labels, as: 'labels'
             property :table_reference, as: 'tableReference', class: Google::Apis::BigqueryV2::TableReference, decorator: Google::Apis::BigqueryV2::TableReference::Representation
         
             property :type, as: 'type'

data/generated/google/apis/books_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/books/docs/v1/getting_started
     module BooksV1
       VERSION = 'V1'
-      REVISION = '20161005'
+      REVISION = '20161206'
 
       # Manage your books
       AUTH_BOOKS = 'https://www.googleapis.com/auth/books'

data/generated/google/apis/books_v1/classes.rb

@@ -2026,6 +2026,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # 
+        # Corresponds to the JSON property `notificationGroup`
+        # @return [String]
+        attr_accessor :notification_group
+      
         # 
         # Corresponds to the JSON property `notification_type`
         # @return [String]
@@ -2070,6 +2075,7 @@ module Google
           @dont_show_notification = args[:dont_show_notification] if args.key?(:dont_show_notification)
           @icon_url = args[:icon_url] if args.key?(:icon_url)
           @kind = args[:kind] if args.key?(:kind)
+          @notification_group = args[:notification_group] if args.key?(:notification_group)
           @notification_type = args[:notification_type] if args.key?(:notification_type)
           @pcampaign_id = args[:pcampaign_id] if args.key?(:pcampaign_id)
           @reason = args[:reason] if args.key?(:reason)
@@ -2413,8 +2419,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Series info list. The client always expects this element in the JSON output,
-        # hence declared here as OutputAlways.
+        # 
         # Corresponds to the JSON property `series`
         # @return [Array<Google::Apis::BooksV1::Series::Series>]
         attr_accessor :series

data/generated/google/apis/books_v1/representations.rb

@@ -1212,6 +1212,7 @@ module Google
           property :dont_show_notification, as: 'dont_show_notification'
           property :icon_url, as: 'iconUrl'
           property :kind, as: 'kind'
+          property :notification_group, as: 'notificationGroup'
           property :notification_type, as: 'notification_type'
           property :pcampaign_id, as: 'pcampaign_id'
           property :reason, as: 'reason'

data/generated/google/apis/calendar_v3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/google-apps/calendar/firstapp
     module CalendarV3
       VERSION = 'V3'
-      REVISION = '20161101'
+      REVISION = '20170115'
 
       # Manage your calendars
       AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'

data/generated/google/apis/classroom_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/classroom/
     module ClassroomV1
       VERSION = 'V1'
-      REVISION = '20161006'
+      REVISION = '20170110'
 
       # View instructions for teacher-assigned work in your Google Classroom classes
       AUTH_CLASSROOM_COURSE_WORK_READONLY = 'https://www.googleapis.com/auth/classroom.course-work.readonly'

data/generated/google/apis/classroom_v1/classes.rb

@@ -572,72 +572,6 @@ module Google
         end
       end
       
-      # Response when listing guardians.
-      class ListGuardiansResponse
-        include Google::Apis::Core::Hashable
-      
-        # Guardians on this page of results that met the criteria specified in the
-        # request.
-        # Corresponds to the JSON property `guardians`
-        # @return [Array<Google::Apis::ClassroomV1::Guardian>]
-        attr_accessor :guardians
-      
-        # Token identifying the next page of results to return. If empty, no further
-        # results are available.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @guardians = args[:guardians] if args.key?(:guardians)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-        end
-      end
-      
-      # Association between a student and a guardian of that student. The guardian may
-      # receive information about the student's course work.
-      class Guardian
-        include Google::Apis::Core::Hashable
-      
-        # Identifier for the student to whom the guardian relationship applies.
-        # Corresponds to the JSON property `studentId`
-        # @return [String]
-        attr_accessor :student_id
-      
-        # Identifier for the guardian.
-        # Corresponds to the JSON property `guardianId`
-        # @return [String]
-        attr_accessor :guardian_id
-      
-        # Global information for a user.
-        # Corresponds to the JSON property `guardianProfile`
-        # @return [Google::Apis::ClassroomV1::UserProfile]
-        attr_accessor :guardian_profile
-      
-        # The email address to which the initial guardian invitation was sent. This
-        # field is only visible to domain administrators.
-        # Corresponds to the JSON property `invitedEmailAddress`
-        # @return [String]
-        attr_accessor :invited_email_address
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @student_id = args[:student_id] if args.key?(:student_id)
-          @guardian_id = args[:guardian_id] if args.key?(:guardian_id)
-          @guardian_profile = args[:guardian_profile] if args.key?(:guardian_profile)
-          @invited_email_address = args[:invited_email_address] if args.key?(:invited_email_address)
-        end
-      end
-      
       # Global information for a user.
       class UserProfile
         include Google::Apis::Core::Hashable
@@ -858,6 +792,72 @@ module Google
         end
       end
       
+      # Response when listing guardians.
+      class ListGuardiansResponse
+        include Google::Apis::Core::Hashable
+      
+        # Guardians on this page of results that met the criteria specified in the
+        # request.
+        # Corresponds to the JSON property `guardians`
+        # @return [Array<Google::Apis::ClassroomV1::Guardian>]
+        attr_accessor :guardians
+      
+        # Token identifying the next page of results to return. If empty, no further
+        # results are available.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @guardians = args[:guardians] if args.key?(:guardians)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # Association between a student and a guardian of that student. The guardian may
+      # receive information about the student's course work.
+      class Guardian
+        include Google::Apis::Core::Hashable
+      
+        # Identifier for the student to whom the guardian relationship applies.
+        # Corresponds to the JSON property `studentId`
+        # @return [String]
+        attr_accessor :student_id
+      
+        # Identifier for the guardian.
+        # Corresponds to the JSON property `guardianId`
+        # @return [String]
+        attr_accessor :guardian_id
+      
+        # Global information for a user.
+        # Corresponds to the JSON property `guardianProfile`
+        # @return [Google::Apis::ClassroomV1::UserProfile]
+        attr_accessor :guardian_profile
+      
+        # The email address to which the initial guardian invitation was sent. This
+        # field is only visible to domain administrators.
+        # Corresponds to the JSON property `invitedEmailAddress`
+        # @return [String]
+        attr_accessor :invited_email_address
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @student_id = args[:student_id] if args.key?(:student_id)
+          @guardian_id = args[:guardian_id] if args.key?(:guardian_id)
+          @guardian_profile = args[:guardian_profile] if args.key?(:guardian_profile)
+          @invited_email_address = args[:invited_email_address] if args.key?(:invited_email_address)
+        end
+      end
+      
       # An invitation to join a course.
       class Invitation
         include Google::Apis::Core::Hashable
@@ -1002,7 +1002,7 @@ module Google
         attr_accessor :max_points
       
         # Type of this course work. The type is set when the course work is created and
-        # cannot be changed. When creating course work, this must be `ASSIGNMENT`.
+        # cannot be changed.
         # Corresponds to the JSON property `workType`
         # @return [String]
         attr_accessor :work_type
@@ -1057,8 +1057,8 @@ module Google
         end
       end
       
-      # Material attached to course work. When creating attachments, only the Link
-      # field may be specified.
+      # Material attached to course work. When creating attachments, setting the `form`
+      # field is not supported.
       class Material
         include Google::Apis::Core::Hashable
       
@@ -1389,10 +1389,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Attachments added by the student. Drive files that correspond to materials
-        # with a share mode of SUBMISSION_COPY may not exist yet if the student has not
+        # with a share mode of STUDENT_COPY may not exist yet if the student has not
         # accessed the assignment in Classroom. Some attachment metadata is only
         # populated if the requesting user has permission to access it. Identifier and
-        # alternate_link fields are available, but others (e.g. title) may not be.
+        # alternate_link fields are always available, but others (e.g. title) may not be.
         # Corresponds to the JSON property `attachments`
         # @return [Array<Google::Apis::ClassroomV1::Attachment>]
         attr_accessor :attachments
@@ -1407,8 +1407,8 @@ module Google
         end
       end
       
-      # Attachment added to student assignment work. When creating attachments, only
-      # the Link field may be specified.
+      # Attachment added to student assignment work. When creating attachments,
+      # setting the `form` field is not supported.
       class Attachment
         include Google::Apis::Core::Hashable
       
@@ -1553,7 +1553,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Attachments to add. A student submission may not have more than 20 attachments.
-        # This may only contain link attachments.
+        # Form attachments are not supported.
         # Corresponds to the JSON property `addAttachments`
         # @return [Array<Google::Apis::ClassroomV1::Attachment>]
         attr_accessor :add_attachments

data/generated/google/apis/classroom_v1/representations.rb

@@ -106,55 +106,55 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ListGuardiansResponse
+      class UserProfile
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Guardian
+      class Name
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class UserProfile
+      class GlobalPermission
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Name
+      class Teacher
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GlobalPermission
+      class ListTeachersResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Teacher
+      class Student
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ListTeachersResponse
+      class ListStudentsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Student
+      class ListGuardiansResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ListStudentsResponse
+      class Guardian
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
@@ -427,26 +427,6 @@ module Google
         end
       end
       
-      class ListGuardiansResponse
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :guardians, as: 'guardians', class: Google::Apis::ClassroomV1::Guardian, decorator: Google::Apis::ClassroomV1::Guardian::Representation
-      
-          property :next_page_token, as: 'nextPageToken'
-        end
-      end
-      
-      class Guardian
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :student_id, as: 'studentId'
-          property :guardian_id, as: 'guardianId'
-          property :guardian_profile, as: 'guardianProfile', class: Google::Apis::ClassroomV1::UserProfile, decorator: Google::Apis::ClassroomV1::UserProfile::Representation
-      
-          property :invited_email_address, as: 'invitedEmailAddress'
-        end
-      end
-      
       class UserProfile
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -516,6 +496,26 @@ module Google
         end
       end
       
+      class ListGuardiansResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :guardians, as: 'guardians', class: Google::Apis::ClassroomV1::Guardian, decorator: Google::Apis::ClassroomV1::Guardian::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Guardian
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :student_id, as: 'studentId'
+          property :guardian_id, as: 'guardianId'
+          property :guardian_profile, as: 'guardianProfile', class: Google::Apis::ClassroomV1::UserProfile, decorator: Google::Apis::ClassroomV1::UserProfile::Representation
+      
+          property :invited_email_address, as: 'invitedEmailAddress'
+        end
+      end
+      
       class Invitation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/classroom_v1/service.rb

@@ -743,9 +743,10 @@ module Google
         # must be made with an OAuth client ID from the associated Developer Console
         # project. This method returns the following error codes: * `PERMISSION_DENIED`
         # if the requesting user is not permitted to access the requested course, create
-        # course work in the requested course, or for access errors. * `INVALID_ARGUMENT`
-        # if the request is malformed. * `NOT_FOUND` if the requested course does not
-        # exist.
+        # course work in the requested course, share a Drive attachment, or for access
+        # errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the
+        # requested course does not exist. * `FAILED_PRECONDITION` for the following
+        # request error: * AttachmentNotVisible
         # @param [String] course_id
         #   Identifier of the course. This identifier can be either the Classroom-assigned
         #   identifier or an alias.
@@ -779,6 +780,105 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates one or more fields of a course work. See google.classroom.v1.
+        # CourseWork for details of which fields may be updated and who may change them.
+        # This request must be made by the Developer Console project of the [OAuth
+        # client ID](https://support.google.com/cloud/answer/6158849) used to create the
+        # corresponding course work item. This method returns the following error codes:
+        # * `PERMISSION_DENIED` if the requesting developer project did not create the
+        # corresponding course work, if the user is not permitted to make the requested
+        # modification to the student submission, or for access errors. * `
+        # INVALID_ARGUMENT` if the request is malformed. * `FAILED_PRECONDITION` if the
+        # requested course work has already been deleted. * `NOT_FOUND` if the requested
+        # course, course work, or student submission does not exist.
+        # @param [String] course_id
+        #   Identifier of the course. This identifier can be either the Classroom-assigned
+        #   identifier or an alias.
+        # @param [String] id
+        #   Identifier of the course work.
+        # @param [Google::Apis::ClassroomV1::CourseWork] course_work_object
+        # @param [String] update_mask
+        #   Mask that identifies which fields on the course work to update. This field is
+        #   required to do an update. The update fails if invalid fields are specified. If
+        #   a field supports empty values, it can be cleared by specifying it in the
+        #   update mask and not in the CourseWork object. If a field that does not support
+        #   empty values is included in the update mask and not set in the CourseWork
+        #   object, an `INVALID_ARGUMENT` error will be returned. The following fields may
+        #   be specified by teachers: * `title` * `description` * `state` * `due_date` * `
+        #   due_time` * `max_points` * `submission_modification_mode`
+        # @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::ClassroomV1::CourseWork] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClassroomV1::CourseWork]
+        #
+        # @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_course_course_work(course_id, id, course_work_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/courses/{courseId}/courseWork/{id}', options)
+          command.request_representation = Google::Apis::ClassroomV1::CourseWork::Representation
+          command.request_object = course_work_object
+          command.response_representation = Google::Apis::ClassroomV1::CourseWork::Representation
+          command.response_class = Google::Apis::ClassroomV1::CourseWork
+          command.params['courseId'] = course_id unless course_id.nil?
+          command.params['id'] = id unless id.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a course work. This request must be made by the Developer Console
+        # project of the [OAuth client ID](https://support.google.com/cloud/answer/
+        # 6158849) used to create the corresponding course work item. This method
+        # returns the following error codes: * `PERMISSION_DENIED` if the requesting
+        # developer project did not create the corresponding course work, if the
+        # requesting user is not permitted to delete the requested course or for access
+        # errors. * `FAILED_PRECONDITION` if the requested course work has already been
+        # deleted. * `NOT_FOUND` if no course exists with the requested ID.
+        # @param [String] course_id
+        #   Identifier of the course. This identifier can be either the Classroom-assigned
+        #   identifier or an alias.
+        # @param [String] id
+        #   Identifier of the course work to delete. This identifier is a Classroom-
+        #   assigned identifier.
+        # @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::ClassroomV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClassroomV1::Empty]
+        #
+        # @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_course_course_work(course_id, id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1/courses/{courseId}/courseWork/{id}', options)
+          command.response_representation = Google::Apis::ClassroomV1::Empty::Representation
+          command.response_class = Google::Apis::ClassroomV1::Empty
+          command.params['courseId'] = course_id unless course_id.nil?
+          command.params['id'] = id unless id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns course work. This method returns the following error codes: * `
         # PERMISSION_DENIED` if the requesting user is not permitted to access the
         # requested course or course work, or for access errors. * `INVALID_ARGUMENT` if
@@ -1091,7 +1191,7 @@ module Google
         
         # Reclaims a student submission on behalf of the student that owns it.
         # Reclaiming a student submission transfers ownership of attached Drive files to
-        # the student and update the submission state. Only the student that ownes the
+        # the student and update the submission state. Only the student that owns the
         # requested student submission may call this method, and only for a student
         # submission that has been turned in. This request must be made by the Developer
         # Console project of the [OAuth client ID](https://support.google.com/cloud/
@@ -1194,15 +1294,15 @@ module Google
         end
         
         # Modifies attachments of student submission. Attachments may only be added to
-        # student submissions whose type is `ASSIGNMENT`. This request must be made by
-        # the Developer Console project of the [OAuth client ID](https://support.google.
-        # com/cloud/answer/6158849) used to create the corresponding course work item.
-        # This method returns the following error codes: * `PERMISSION_DENIED` if the
-        # requesting user is not permitted to access the requested course or course work,
-        # if the user is not permitted to modify attachments on the requested student
-        # submission, or for access errors. * `INVALID_ARGUMENT` if the request is
-        # malformed. * `NOT_FOUND` if the requested course, course work, or student
-        # submission does not exist.
+        # student submissions belonging to course work objects with a `workType` of `
+        # ASSIGNMENT`. This request must be made by the Developer Console project of the
+        # [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to
+        # create the corresponding course work item. This method returns the following
+        # error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to
+        # access the requested course or course work, if the user is not permitted to
+        # modify attachments on the requested student submission, or for access errors. *
+        # `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the
+        # requested course, course work, or student submission does not exist.
         # @param [String] course_id
         #   Identifier of the course. This identifier can be either the Classroom-assigned
         #   identifier or an alias.
@@ -1244,7 +1344,7 @@ module Google
         
         # Returns a user profile. This method returns the following error codes: * `
         # PERMISSION_DENIED` if the requesting user is not permitted to access this user
-        # profile or if no profile exists with the requested ID or for access errors.
+        # profile, if no profile exists with the requested ID, or for access errors.
         # @param [String] user_id
         #   Identifier of the profile to return. The identifier can be one of the
         #   following: * the numeric identifier for the user * the email address of the
@@ -1554,13 +1654,15 @@ module Google
         end
         
         # Returns a specific guardian. This method returns the following error codes: * `
-        # PERMISSION_DENIED` if the requesting user is not permitted to view guardian
-        # information for the student identified by the `student_id`, if guardians are
-        # not enabled for the domain in question, or for other access errors. * `
-        # INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be
-        # recognized (it is not an email address, nor a `student_id` from the API, nor
-        # the literal string `me`). * `NOT_FOUND` if Classroom cannot find any record of
-        # the given student or `guardian_id`, or if the guardian has been disabled.
+        # PERMISSION_DENIED` if no user that matches the provided `student_id` is
+        # visible to the requesting user, if the requesting user is not permitted to
+        # view guardian information for the student identified by the `student_id`, if
+        # guardians are not enabled for the domain in question, or for other access
+        # errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format
+        # cannot be recognized (it is not an email address, nor a `student_id` from the
+        # API, nor the literal string `me`). * `NOT_FOUND` if the requesting user is
+        # permitted to view guardians for the requested `student_id`, but no `Guardian`
+        # record exists for that student that matches the provided `guardian_id`.
         # @param [String] student_id
         #   The student whose guardian is being requested. One of the following: * the
         #   numeric identifier for the user * the email address of the user * the string
@@ -1597,13 +1699,15 @@ module Google
         
         # Deletes a guardian. The guardian will no longer receive guardian notifications
         # and the guardian will no longer be accessible via the API. This method returns
-        # the following error codes: * `PERMISSION_DENIED` if the requesting user is not
-        # permitted to manage guardians for the student identified by the `student_id`,
-        # if guardians are not enabled for the domain in question, or for other access
-        # errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format
-        # cannot be recognized (it is not an email address, nor a `student_id` from the
-        # API). * `NOT_FOUND` if Classroom cannot find any record of the given `
-        # student_id` or `guardian_id`, or if the guardian has already been disabled.
+        # the following error codes: * `PERMISSION_DENIED` if no user that matches the
+        # provided `student_id` is visible to the requesting user, if the requesting
+        # user is not permitted to manage guardians for the student identified by the `
+        # student_id`, if guardians are not enabled for the domain in question, or for
+        # other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but
+        # its format cannot be recognized (it is not an email address, nor a `student_id`
+        # from the API). * `NOT_FOUND` if the requesting user is permitted to modify
+        # guardians for the requested `student_id`, but no `Guardian` record exists for
+        # that student with the provided `guardian_id`.
         # @param [String] student_id
         #   The student whose guardian is to be deleted. One of the following: * the
         #   numeric identifier for the user * the email address of the user * the string