appsactivity - ActiveState ActiveGo 1.8
...

Package appsactivity

import "google.golang.org/api/appsactivity/v1"
Overview
Index

Overview ▾

Package appsactivity provides access to the G Suite Activity API.

See https://developers.google.com/google-apps/activity/

Usage example:

import "google.golang.org/api/appsactivity/v1"
...
appsactivityService, err := appsactivity.New(oauthHttpClient)

Index ▾

Constants
type ActivitiesListCall
    func (c *ActivitiesListCall) Context(ctx context.Context) *ActivitiesListCall
    func (c *ActivitiesListCall) Do(opts ...googleapi.CallOption) (*ListActivitiesResponse, error)
    func (c *ActivitiesListCall) DriveAncestorId(driveAncestorId string) *ActivitiesListCall
    func (c *ActivitiesListCall) DriveFileId(driveFileId string) *ActivitiesListCall
    func (c *ActivitiesListCall) Fields(s ...googleapi.Field) *ActivitiesListCall
    func (c *ActivitiesListCall) GroupingStrategy(groupingStrategy string) *ActivitiesListCall
    func (c *ActivitiesListCall) Header() http.Header
    func (c *ActivitiesListCall) IfNoneMatch(entityTag string) *ActivitiesListCall
    func (c *ActivitiesListCall) PageSize(pageSize int64) *ActivitiesListCall
    func (c *ActivitiesListCall) PageToken(pageToken string) *ActivitiesListCall
    func (c *ActivitiesListCall) Pages(ctx context.Context, f func(*ListActivitiesResponse) error) error
    func (c *ActivitiesListCall) Source(source string) *ActivitiesListCall
    func (c *ActivitiesListCall) UserId(userId string) *ActivitiesListCall
type ActivitiesService
    func NewActivitiesService(s *Service) *ActivitiesService
    func (r *ActivitiesService) List() *ActivitiesListCall
type Activity
    func (s *Activity) MarshalJSON() ([]byte, error)
type Event
    func (s *Event) MarshalJSON() ([]byte, error)
type ListActivitiesResponse
    func (s *ListActivitiesResponse) MarshalJSON() ([]byte, error)
type Move
    func (s *Move) MarshalJSON() ([]byte, error)
type Parent
    func (s *Parent) MarshalJSON() ([]byte, error)
type Permission
    func (s *Permission) MarshalJSON() ([]byte, error)
type PermissionChange
    func (s *PermissionChange) MarshalJSON() ([]byte, error)
type Photo
    func (s *Photo) MarshalJSON() ([]byte, error)
type Rename
    func (s *Rename) MarshalJSON() ([]byte, error)
type Service
    func New(client *http.Client) (*Service, error)
type Target
    func (s *Target) MarshalJSON() ([]byte, error)
type User
    func (s *User) MarshalJSON() ([]byte, error)

Package files

appsactivity-gen.go

Constants

OAuth2 scopes used by this API.

const (
    // View the activity history of your Google apps
    ActivityScope = "https://www.googleapis.com/auth/activity"

    // View and manage the files in your Google Drive
    DriveScope = "https://www.googleapis.com/auth/drive"

    // View and manage metadata of files in your Google Drive
    DriveMetadataScope = "https://www.googleapis.com/auth/drive.metadata"

    // View metadata for files in your Google Drive
    DriveMetadataReadonlyScope = "https://www.googleapis.com/auth/drive.metadata.readonly"

    // View the files in your Google Drive
    DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly"
)

type ActivitiesListCall

type ActivitiesListCall struct {
    // contains filtered or unexported fields
}

func (*ActivitiesListCall) Context

func (c *ActivitiesListCall) Context(ctx context.Context) *ActivitiesListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ActivitiesListCall) Do

func (c *ActivitiesListCall) Do(opts ...googleapi.CallOption) (*ListActivitiesResponse, error)

Do executes the "appsactivity.activities.list" call. Exactly one of *ListActivitiesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListActivitiesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ActivitiesListCall) DriveAncestorId

func (c *ActivitiesListCall) DriveAncestorId(driveAncestorId string) *ActivitiesListCall

DriveAncestorId sets the optional parameter "drive.ancestorId": Identifies the Drive folder containing the items for which to return activities.

func (*ActivitiesListCall) DriveFileId

func (c *ActivitiesListCall) DriveFileId(driveFileId string) *ActivitiesListCall

DriveFileId sets the optional parameter "drive.fileId": Identifies the Drive item to return activities for.

func (*ActivitiesListCall) Fields

func (c *ActivitiesListCall) Fields(s ...googleapi.Field) *ActivitiesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ActivitiesListCall) GroupingStrategy

func (c *ActivitiesListCall) GroupingStrategy(groupingStrategy string) *ActivitiesListCall

GroupingStrategy sets the optional parameter "groupingStrategy": Indicates the strategy to use when grouping singleEvents items in the associated combinedEvent object.

Possible values:

"driveUi" (default)
"none"

func (*ActivitiesListCall) Header

func (c *ActivitiesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ActivitiesListCall) IfNoneMatch

func (c *ActivitiesListCall) IfNoneMatch(entityTag string) *ActivitiesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ActivitiesListCall) PageSize

func (c *ActivitiesListCall) PageSize(pageSize int64) *ActivitiesListCall

PageSize sets the optional parameter "pageSize": The maximum number of events to return on a page. The response includes a continuation token if there are more events.

func (*ActivitiesListCall) PageToken

func (c *ActivitiesListCall) PageToken(pageToken string) *ActivitiesListCall

PageToken sets the optional parameter "pageToken": A token to retrieve a specific page of results.

func (*ActivitiesListCall) Pages

func (c *ActivitiesListCall) Pages(ctx context.Context, f func(*ListActivitiesResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*ActivitiesListCall) Source

func (c *ActivitiesListCall) Source(source string) *ActivitiesListCall

Source sets the optional parameter "source": The Google service from which to return activities. Possible values of source are: - drive.google.com

func (*ActivitiesListCall) UserId

func (c *ActivitiesListCall) UserId(userId string) *ActivitiesListCall

UserId sets the optional parameter "userId": Indicates the user to return activity for. Use the special value me to indicate the currently authenticated user.

type ActivitiesService

type ActivitiesService struct {
    // contains filtered or unexported fields
}

func NewActivitiesService

func NewActivitiesService(s *Service) *ActivitiesService

func (*ActivitiesService) List

func (r *ActivitiesService) List() *ActivitiesListCall

List: 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.

type Activity

Activity: 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.

type Activity struct {
    // CombinedEvent: The fields common to all of the singleEvents that make
    // up the Activity.
    CombinedEvent *Event `json:"combinedEvent,omitempty"`

    // SingleEvents: A list of all the Events that make up the Activity.
    SingleEvents []*Event `json:"singleEvents,omitempty"`

    // ForceSendFields is a list of field names (e.g. "CombinedEvent") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "CombinedEvent") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Activity) MarshalJSON

func (s *Activity) MarshalJSON() ([]byte, error)

type Event

Event: Represents the changes associated with an action taken by a user.

type Event struct {
    // AdditionalEventTypes: 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.
    //
    // Possible values:
    //   "comment"
    //   "create"
    //   "edit"
    //   "emptyTrash"
    //   "move"
    //   "permissionChange"
    //   "rename"
    //   "trash"
    //   "unknown"
    //   "untrash"
    //   "upload"
    AdditionalEventTypes []string `json:"additionalEventTypes,omitempty"`

    // EventTimeMillis: The time at which the event occurred formatted as
    // Unix time in milliseconds.
    EventTimeMillis uint64 `json:"eventTimeMillis,omitempty,string"`

    // FromUserDeletion: Whether this event is caused by a user being
    // deleted.
    FromUserDeletion bool `json:"fromUserDeletion,omitempty"`

    // Move: Extra information for move type events, such as changes in an
    // object's parents.
    Move *Move `json:"move,omitempty"`

    // PermissionChanges: Extra information for permissionChange type
    // events, such as the user or group the new permission applies to.
    PermissionChanges []*PermissionChange `json:"permissionChanges,omitempty"`

    // PrimaryEventType: The main type of event that occurred.
    //
    // Possible values:
    //   "comment"
    //   "create"
    //   "edit"
    //   "emptyTrash"
    //   "move"
    //   "permissionChange"
    //   "rename"
    //   "trash"
    //   "unknown"
    //   "untrash"
    //   "upload"
    PrimaryEventType string `json:"primaryEventType,omitempty"`

    // Rename: Extra information for rename type events, such as the old and
    // new names.
    Rename *Rename `json:"rename,omitempty"`

    // Target: Information specific to the Target object modified by the
    // event.
    Target *Target `json:"target,omitempty"`

    // User: Represents the user responsible for the event.
    User *User `json:"user,omitempty"`

    // ForceSendFields is a list of field names (e.g.
    // "AdditionalEventTypes") to unconditionally include in API requests.
    // By default, fields with empty values are omitted from API requests.
    // However, any non-pointer, non-interface field appearing in
    // ForceSendFields will be sent to the server regardless of whether the
    // field is empty or not. This may be used to include empty fields in
    // Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AdditionalEventTypes") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

func (*Event) MarshalJSON

func (s *Event) MarshalJSON() ([]byte, error)

type ListActivitiesResponse

ListActivitiesResponse: The response from the list request. Contains a list of activities and a token to retrieve the next page of results.

type ListActivitiesResponse struct {
    // Activities: List of activities.
    Activities []*Activity `json:"activities,omitempty"`

    // NextPageToken: Token for the next page of results.
    NextPageToken string `json:"nextPageToken,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Activities") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Activities") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*ListActivitiesResponse) MarshalJSON

func (s *ListActivitiesResponse) MarshalJSON() ([]byte, error)

type Move

Move: Contains information about changes in an object's parents as a result of a move type event.

type Move struct {
    // AddedParents: The added parent(s).
    AddedParents []*Parent `json:"addedParents,omitempty"`

    // RemovedParents: The removed parent(s).
    RemovedParents []*Parent `json:"removedParents,omitempty"`

    // ForceSendFields is a list of field names (e.g. "AddedParents") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AddedParents") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Move) MarshalJSON

func (s *Move) MarshalJSON() ([]byte, error)

type Parent

Parent: Contains information about a parent object. For example, a folder in Drive is a parent for all files within it.

type Parent struct {
    // Id: The parent's ID.
    Id string `json:"id,omitempty"`

    // IsRoot: Whether this is the root folder.
    IsRoot bool `json:"isRoot,omitempty"`

    // Title: The parent's title.
    Title string `json:"title,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Id") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Id") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Parent) MarshalJSON

func (s *Parent) MarshalJSON() ([]byte, error)

type Permission

Permission: 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.

type Permission struct {
    // Name: The name of the user or group the permission applies to.
    Name string `json:"name,omitempty"`

    // PermissionId: The ID for this permission. Corresponds to the Drive
    // API's permission ID returned as part of the Drive Permissions
    // resource.
    PermissionId string `json:"permissionId,omitempty"`

    // Role: Indicates the Google Drive permissions role. The role
    // determines a user's ability to read, write, or comment on the file.
    //
    // Possible values:
    //   "commenter"
    //   "owner"
    //   "reader"
    //   "writer"
    Role string `json:"role,omitempty"`

    // Type: Indicates how widely permissions are granted.
    //
    // Possible values:
    //   "anyone"
    //   "domain"
    //   "group"
    //   "user"
    Type string `json:"type,omitempty"`

    // User: The user's information if the type is USER.
    User *User `json:"user,omitempty"`

    // WithLink: Whether the permission requires a link to the file.
    WithLink bool `json:"withLink,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Name") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Name") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Permission) MarshalJSON

func (s *Permission) MarshalJSON() ([]byte, error)

type PermissionChange

PermissionChange: Contains information about a Drive object's permissions that changed as a result of a permissionChange type event.

type PermissionChange struct {
    // AddedPermissions: Lists all Permission objects added.
    AddedPermissions []*Permission `json:"addedPermissions,omitempty"`

    // RemovedPermissions: Lists all Permission objects removed.
    RemovedPermissions []*Permission `json:"removedPermissions,omitempty"`

    // ForceSendFields is a list of field names (e.g. "AddedPermissions") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AddedPermissions") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

func (*PermissionChange) MarshalJSON

func (s *PermissionChange) MarshalJSON() ([]byte, error)

type Photo

Photo: Photo information for a user.

type Photo struct {
    // Url: The URL of the photo.
    Url string `json:"url,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Url") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Url") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Photo) MarshalJSON

func (s *Photo) MarshalJSON() ([]byte, error)

type Rename

Rename: Contains information about a renametype event.

type Rename struct {
    // NewTitle: The new title.
    NewTitle string `json:"newTitle,omitempty"`

    // OldTitle: The old title.
    OldTitle string `json:"oldTitle,omitempty"`

    // ForceSendFields is a list of field names (e.g. "NewTitle") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "NewTitle") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Rename) MarshalJSON

func (s *Rename) MarshalJSON() ([]byte, error)

type Service

type Service struct {
    BasePath  string // API endpoint base URL
    UserAgent string // optional additional User-Agent fragment

    Activities *ActivitiesService
    // contains filtered or unexported fields
}

func New

func New(client *http.Client) (*Service, error)

type Target

Target: Information about the object modified by the event.

type Target struct {
    // Id: The ID of the target. For example, in Google Drive, this is the
    // file or folder ID.
    Id string `json:"id,omitempty"`

    // MimeType: The MIME type of the target.
    MimeType string `json:"mimeType,omitempty"`

    // Name: The name of the target. For example, in Google Drive, this is
    // the title of the file.
    Name string `json:"name,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Id") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Id") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*Target) MarshalJSON

func (s *Target) MarshalJSON() ([]byte, error)

type User

User: A representation of a user.

type User struct {
    // IsDeleted: A boolean which indicates whether the specified User was
    // deleted. If true, name, photo and permission_id will be omitted.
    IsDeleted bool `json:"isDeleted,omitempty"`

    // IsMe: Whether the user is the authenticated user.
    IsMe bool `json:"isMe,omitempty"`

    // Name: The displayable name of the user.
    Name string `json:"name,omitempty"`

    // PermissionId: The permission ID associated with this user. Equivalent
    // to the Drive API's permission ID for this user, returned as part of
    // the Drive Permissions resource.
    PermissionId string `json:"permissionId,omitempty"`

    // Photo: The profile photo of the user. Not present if the user has no
    // profile photo.
    Photo *Photo `json:"photo,omitempty"`

    // ForceSendFields is a list of field names (e.g. "IsDeleted") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "IsDeleted") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*User) MarshalJSON

func (s *User) MarshalJSON() ([]byte, error)