api: google.golang.org/api/appsactivity/v1 Index | Files

package appsactivity

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

Package appsactivity provides access to the Drive Activity API.

For product documentation, see: https://developers.google.com/google-apps/activity/

Creating a client

Usage example:

import "google.golang.org/api/appsactivity/v1"
...
ctx := context.Background()
appsactivityService, err := appsactivity.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication.

For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:

appsactivityService, err := appsactivity.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
appsactivityService, err := appsactivity.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See https://godoc.org/google.golang.org/api/option/ for details on options.

Index

Package Files

appsactivity-gen.go

Constants

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

OAuth2 scopes used by this API.

type ActivitiesListCall Uses

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

func (*ActivitiesListCall) Context Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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 Uses

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

UserId sets the optional parameter "userId": The ID used for ACL checks (does not filter the resulting event list by the assigned value). Use the special value me to indicate the currently authenticated user.

type ActivitiesService Uses

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

func NewActivitiesService Uses

func NewActivitiesService(s *Service) *ActivitiesService

func (*ActivitiesService) List Uses

func (r *ActivitiesService) List() *ActivitiesListCall

List: Returns a list of activities visible to the current logged in user. Visible activities are determined by the visibility 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 Uses

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:"-"`
}

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.

func (*Activity) MarshalJSON Uses

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

type Event Uses

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:"-"`
}

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

func (*Event) MarshalJSON Uses

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

type ListActivitiesResponse Uses

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:"-"`
}

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

func (*ListActivitiesResponse) MarshalJSON Uses

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

type Move Uses

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:"-"`
}

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

func (*Move) MarshalJSON Uses

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

type Parent Uses

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:"-"`
}

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

func (*Parent) MarshalJSON Uses

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

type Permission Uses

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"
    //   "publishedReader"
    //   "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:"-"`
}

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.

func (*Permission) MarshalJSON Uses

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

type PermissionChange Uses

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:"-"`
}

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

func (*PermissionChange) MarshalJSON Uses

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

type Photo Uses

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:"-"`
}

Photo: Photo information for a user.

func (*Photo) MarshalJSON Uses

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

type Rename Uses

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:"-"`
}

Rename: Contains information about a renametype event.

func (*Rename) MarshalJSON Uses

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

type Service Uses

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 Uses

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

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService Uses

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type Target Uses

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:"-"`
}

Target: Information about the object modified by the event.

func (*Target) MarshalJSON Uses

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

type User Uses

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:"-"`
}

User: A representation of a user.

func (*User) MarshalJSON Uses

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

Package appsactivity imports 14 packages (graph) and is imported by 1 packages. Updated 2019-09-23. Refresh now. Tools for package owners.