google-api-client 0.8.3 → 0.9

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

@@ -0,0 +1,392 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module AppsactivityV1
+      
+      # An Activity resource is a combined view of multiple events. An activity has a
+      # list of individual events and a combined view of the common fields among all
+      # events.
+      class Activity
+        include Google::Apis::Core::Hashable
+      
+        # Represents the changes associated with an action taken by a user.
+        # Corresponds to the JSON property `combinedEvent`
+        # @return [Google::Apis::AppsactivityV1::Event]
+        attr_accessor :combined_event
+      
+        # A list of all the Events that make up the Activity.
+        # Corresponds to the JSON property `singleEvents`
+        # @return [Array<Google::Apis::AppsactivityV1::Event>]
+        attr_accessor :single_events
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @combined_event = args[:combined_event] unless args[:combined_event].nil?
+          @single_events = args[:single_events] unless args[:single_events].nil?
+        end
+      end
+      
+      # Represents the changes associated with an action taken by a user.
+      class Event
+        include Google::Apis::Core::Hashable
+      
+        # Additional event types. Some events may have multiple types when multiple
+        # actions are part of a single event. For example, creating a document, renaming
+        # it, and sharing it may be part of a single file-creation event.
+        # Corresponds to the JSON property `additionalEventTypes`
+        # @return [Array<String>]
+        attr_accessor :additional_event_types
+      
+        # The time at which the event occurred formatted as Unix time in milliseconds.
+        # Corresponds to the JSON property `eventTimeMillis`
+        # @return [String]
+        attr_accessor :event_time_millis
+      
+        # Whether this event is caused by a user being deleted.
+        # Corresponds to the JSON property `fromUserDeletion`
+        # @return [Boolean]
+        attr_accessor :from_user_deletion
+        alias_method :from_user_deletion?, :from_user_deletion
+      
+        # Contains information about changes in an object's parents as a result of a
+        # move type event.
+        # Corresponds to the JSON property `move`
+        # @return [Google::Apis::AppsactivityV1::Move]
+        attr_accessor :move
+      
+        # Extra information for permissionChange type events, such as the user or group
+        # the new permission applies to.
+        # Corresponds to the JSON property `permissionChanges`
+        # @return [Array<Google::Apis::AppsactivityV1::PermissionChange>]
+        attr_accessor :permission_changes
+      
+        # The main type of event that occurred.
+        # Corresponds to the JSON property `primaryEventType`
+        # @return [String]
+        attr_accessor :primary_event_type
+      
+        # Contains information about a renametype event.
+        # Corresponds to the JSON property `rename`
+        # @return [Google::Apis::AppsactivityV1::Rename]
+        attr_accessor :rename
+      
+        # Information about the object modified by the event.
+        # Corresponds to the JSON property `target`
+        # @return [Google::Apis::AppsactivityV1::Target]
+        attr_accessor :target
+      
+        # A representation of a user.
+        # Corresponds to the JSON property `user`
+        # @return [Google::Apis::AppsactivityV1::User]
+        attr_accessor :user
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_event_types = args[:additional_event_types] unless args[:additional_event_types].nil?
+          @event_time_millis = args[:event_time_millis] unless args[:event_time_millis].nil?
+          @from_user_deletion = args[:from_user_deletion] unless args[:from_user_deletion].nil?
+          @move = args[:move] unless args[:move].nil?
+          @permission_changes = args[:permission_changes] unless args[:permission_changes].nil?
+          @primary_event_type = args[:primary_event_type] unless args[:primary_event_type].nil?
+          @rename = args[:rename] unless args[:rename].nil?
+          @target = args[:target] unless args[:target].nil?
+          @user = args[:user] unless args[:user].nil?
+        end
+      end
+      
+      # The response from the list request. Contains a list of activities and a token
+      # to retrieve the next page of results.
+      class ListActivitiesResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of activities.
+        # Corresponds to the JSON property `activities`
+        # @return [Array<Google::Apis::AppsactivityV1::Activity>]
+        attr_accessor :activities
+      
+        # Token for the next page of results.
+        # 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)
+          @activities = args[:activities] unless args[:activities].nil?
+          @next_page_token = args[:next_page_token] unless args[:next_page_token].nil?
+        end
+      end
+      
+      # Contains information about changes in an object's parents as a result of a
+      # move type event.
+      class Move
+        include Google::Apis::Core::Hashable
+      
+        # The added parent(s).
+        # Corresponds to the JSON property `addedParents`
+        # @return [Array<Google::Apis::AppsactivityV1::Parent>]
+        attr_accessor :added_parents
+      
+        # The removed parent(s).
+        # Corresponds to the JSON property `removedParents`
+        # @return [Array<Google::Apis::AppsactivityV1::Parent>]
+        attr_accessor :removed_parents
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @added_parents = args[:added_parents] unless args[:added_parents].nil?
+          @removed_parents = args[:removed_parents] unless args[:removed_parents].nil?
+        end
+      end
+      
+      # Contains information about a parent object. For example, a folder in Drive is
+      # a parent for all files within it.
+      class Parent
+        include Google::Apis::Core::Hashable
+      
+        # The parent's ID.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Whether this is the root folder.
+        # Corresponds to the JSON property `isRoot`
+        # @return [Boolean]
+        attr_accessor :is_root
+        alias_method :is_root?, :is_root
+      
+        # The parent's title.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @id = args[:id] unless args[:id].nil?
+          @is_root = args[:is_root] unless args[:is_root].nil?
+          @title = args[:title] unless args[:title].nil?
+        end
+      end
+      
+      # Contains information about the permissions and type of access allowed with
+      # regards to a Google Drive object. This is a subset of the fields contained in
+      # a corresponding Drive Permissions object.
+      class Permission
+        include Google::Apis::Core::Hashable
+      
+        # The name of the user or group the permission applies to.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The ID for this permission. Corresponds to the Drive API's permission ID
+        # returned as part of the Drive Permissions resource.
+        # Corresponds to the JSON property `permissionId`
+        # @return [String]
+        attr_accessor :permission_id
+      
+        # Indicates the Google Drive permissions role. The role determines a user's
+        # ability to read, write, or comment on the file.
+        # Corresponds to the JSON property `role`
+        # @return [String]
+        attr_accessor :role
+      
+        # Indicates how widely permissions are granted.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # A representation of a user.
+        # Corresponds to the JSON property `user`
+        # @return [Google::Apis::AppsactivityV1::User]
+        attr_accessor :user
+      
+        # Whether the permission requires a link to the file.
+        # Corresponds to the JSON property `withLink`
+        # @return [Boolean]
+        attr_accessor :with_link
+        alias_method :with_link?, :with_link
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] unless args[:name].nil?
+          @permission_id = args[:permission_id] unless args[:permission_id].nil?
+          @role = args[:role] unless args[:role].nil?
+          @type = args[:type] unless args[:type].nil?
+          @user = args[:user] unless args[:user].nil?
+          @with_link = args[:with_link] unless args[:with_link].nil?
+        end
+      end
+      
+      # Contains information about a Drive object's permissions that changed as a
+      # result of a permissionChange type event.
+      class PermissionChange
+        include Google::Apis::Core::Hashable
+      
+        # Lists all Permission objects added.
+        # Corresponds to the JSON property `addedPermissions`
+        # @return [Array<Google::Apis::AppsactivityV1::Permission>]
+        attr_accessor :added_permissions
+      
+        # Lists all Permission objects removed.
+        # Corresponds to the JSON property `removedPermissions`
+        # @return [Array<Google::Apis::AppsactivityV1::Permission>]
+        attr_accessor :removed_permissions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @added_permissions = args[:added_permissions] unless args[:added_permissions].nil?
+          @removed_permissions = args[:removed_permissions] unless args[:removed_permissions].nil?
+        end
+      end
+      
+      # Photo information for a user.
+      class Photo
+        include Google::Apis::Core::Hashable
+      
+        # The URL of the photo.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @url = args[:url] unless args[:url].nil?
+        end
+      end
+      
+      # Contains information about a renametype event.
+      class Rename
+        include Google::Apis::Core::Hashable
+      
+        # The new title.
+        # Corresponds to the JSON property `newTitle`
+        # @return [String]
+        attr_accessor :new_title
+      
+        # The old title.
+        # Corresponds to the JSON property `oldTitle`
+        # @return [String]
+        attr_accessor :old_title
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @new_title = args[:new_title] unless args[:new_title].nil?
+          @old_title = args[:old_title] unless args[:old_title].nil?
+        end
+      end
+      
+      # Information about the object modified by the event.
+      class Target
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the target. For example, in Google Drive, this is the file or folder
+        # ID.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The MIME type of the target.
+        # Corresponds to the JSON property `mimeType`
+        # @return [String]
+        attr_accessor :mime_type
+      
+        # The name of the target. For example, in Google Drive, this is the title of the
+        # file.
+        # 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)
+          @id = args[:id] unless args[:id].nil?
+          @mime_type = args[:mime_type] unless args[:mime_type].nil?
+          @name = args[:name] unless args[:name].nil?
+        end
+      end
+      
+      # A representation of a user.
+      class User
+        include Google::Apis::Core::Hashable
+      
+        # The displayable name of the user.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Photo information for a user.
+        # Corresponds to the JSON property `photo`
+        # @return [Google::Apis::AppsactivityV1::Photo]
+        attr_accessor :photo
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] unless args[:name].nil?
+          @photo = args[:photo] unless args[:photo].nil?
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,184 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module AppsactivityV1
+      
+      class Activity
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Event
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListActivitiesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Move
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Parent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Permission
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class PermissionChange
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Photo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Rename
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Target
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class User
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Activity
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :combined_event, as: 'combinedEvent', class: Google::Apis::AppsactivityV1::Event, decorator: Google::Apis::AppsactivityV1::Event::Representation
+      
+          collection :single_events, as: 'singleEvents', class: Google::Apis::AppsactivityV1::Event, decorator: Google::Apis::AppsactivityV1::Event::Representation
+      
+        end
+      end
+      
+      class Event
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :additional_event_types, as: 'additionalEventTypes'
+          property :event_time_millis, as: 'eventTimeMillis'
+          property :from_user_deletion, as: 'fromUserDeletion'
+          property :move, as: 'move', class: Google::Apis::AppsactivityV1::Move, decorator: Google::Apis::AppsactivityV1::Move::Representation
+      
+          collection :permission_changes, as: 'permissionChanges', class: Google::Apis::AppsactivityV1::PermissionChange, decorator: Google::Apis::AppsactivityV1::PermissionChange::Representation
+      
+          property :primary_event_type, as: 'primaryEventType'
+          property :rename, as: 'rename', class: Google::Apis::AppsactivityV1::Rename, decorator: Google::Apis::AppsactivityV1::Rename::Representation
+      
+          property :target, as: 'target', class: Google::Apis::AppsactivityV1::Target, decorator: Google::Apis::AppsactivityV1::Target::Representation
+      
+          property :user, as: 'user', class: Google::Apis::AppsactivityV1::User, decorator: Google::Apis::AppsactivityV1::User::Representation
+      
+        end
+      end
+      
+      class ListActivitiesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :activities, as: 'activities', class: Google::Apis::AppsactivityV1::Activity, decorator: Google::Apis::AppsactivityV1::Activity::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Move
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :added_parents, as: 'addedParents', class: Google::Apis::AppsactivityV1::Parent, decorator: Google::Apis::AppsactivityV1::Parent::Representation
+      
+          collection :removed_parents, as: 'removedParents', class: Google::Apis::AppsactivityV1::Parent, decorator: Google::Apis::AppsactivityV1::Parent::Representation
+      
+        end
+      end
+      
+      class Parent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :id, as: 'id'
+          property :is_root, as: 'isRoot'
+          property :title, as: 'title'
+        end
+      end
+      
+      class Permission
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :permission_id, as: 'permissionId'
+          property :role, as: 'role'
+          property :type, as: 'type'
+          property :user, as: 'user', class: Google::Apis::AppsactivityV1::User, decorator: Google::Apis::AppsactivityV1::User::Representation
+      
+          property :with_link, as: 'withLink'
+        end
+      end
+      
+      class PermissionChange
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :added_permissions, as: 'addedPermissions', class: Google::Apis::AppsactivityV1::Permission, decorator: Google::Apis::AppsactivityV1::Permission::Representation
+      
+          collection :removed_permissions, as: 'removedPermissions', class: Google::Apis::AppsactivityV1::Permission, decorator: Google::Apis::AppsactivityV1::Permission::Representation
+      
+        end
+      end
+      
+      class Photo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :url, as: 'url'
+        end
+      end
+      
+      class Rename
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :new_title, as: 'newTitle'
+          property :old_title, as: 'oldTitle'
+        end
+      end
+      
+      class Target
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :id, as: 'id'
+          property :mime_type, as: 'mimeType'
+          property :name, as: 'name'
+        end
+      end
+      
+      class User
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :photo, as: 'photo', class: Google::Apis::AppsactivityV1::Photo, decorator: Google::Apis::AppsactivityV1::Photo::Representation
+      
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,128 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module AppsactivityV1
+      # Google Apps Activity API
+      #
+      # Provides a historical view of activity.
+      #
+      # @example
+      #    require 'google/apis/appsactivity_v1'
+      #
+      #    Appsactivity = Google::Apis::AppsactivityV1 # Alias the module
+      #    service = Appsactivity::AppsactivityService.new
+      #
+      # @see https://developers.google.com/google-apps/activity/
+      class AppsactivityService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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.
+        #  Overrides userIp if both are provided.
+        attr_accessor :quota_user
+
+        # @return [String]
+        #  IP address of the site where the request originates. Use this if you want to
+        #  enforce per-user limits.
+        attr_accessor :user_ip
+
+        def initialize
+          super('https://www.googleapis.com/', 'appsactivity/v1/')
+        end
+        
+        # Returns a list of activities visible to the current logged in user. Visible
+        # activities are determined by the visiblity settings of the object that was
+        # acted on, e.g. Drive files a user can see. An activity is a record of past
+        # events. Multiple events may be merged if they are similar. A request is scoped
+        # to activities from a given Google service using the source parameter.
+        # @param [String] drive_ancestor_id
+        #   Identifies the Drive folder containing the items for which to return
+        #   activities.
+        # @param [String] drive_file_id
+        #   Identifies the Drive item to return activities for.
+        # @param [String] grouping_strategy
+        #   Indicates the strategy to use when grouping singleEvents items in the
+        #   associated combinedEvent object.
+        # @param [Fixnum] page_size
+        #   The maximum number of events to return on a page. The response includes a
+        #   continuation token if there are more events.
+        # @param [String] page_token
+        #   A token to retrieve a specific page of results.
+        # @param [String] source
+        #   The Google service from which to return activities. Possible values of source
+        #   are:
+        #   - drive.google.com
+        # @param [String] user_id
+        #   Indicates the user to return activity for. Use the special value me to
+        #   indicate the currently authenticated user.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AppsactivityV1::ListActivitiesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppsactivityV1::ListActivitiesResponse]
+        #
+        # @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(drive_ancestor_id: nil, drive_file_id: nil, grouping_strategy: nil, page_size: nil, page_token: nil, source: nil, user_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'activities', options)
+          command.response_representation = Google::Apis::AppsactivityV1::ListActivitiesResponse::Representation
+          command.response_class = Google::Apis::AppsactivityV1::ListActivitiesResponse
+          command.query['drive.ancestorId'] = drive_ancestor_id unless drive_ancestor_id.nil?
+          command.query['drive.fileId'] = drive_file_id unless drive_file_id.nil?
+          command.query['groupingStrategy'] = grouping_strategy unless grouping_strategy.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['source'] = source unless source.nil?
+          command.query['userId'] = user_id unless user_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
+
+        protected
+
+        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
+  end
+end