analytics

package
v0.210.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 4, 2024 License: BSD-3-Clause Imports: 14 Imported by: 0

Documentation

Overview

Package analytics provides access to the Google Analytics API.

For product documentation, see: https://developers.google.com/analytics/

Creating a client

Usage example:

import "google.golang.org/api/analytics/v2.4"
...
ctx := context.Background()
analyticsService, err := analytics.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

By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:

analyticsService, err := analytics.NewService(ctx, option.WithScopes(analytics.AnalyticsReadonlyScope))

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

analyticsService, err := analytics.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, ...)
analyticsService, err := analytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

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

Index

Constants

View Source
const (
	// View and manage your Google Analytics data
	AnalyticsScope = "https://www.googleapis.com/auth/analytics"

	// View your Google Analytics data
	AnalyticsReadonlyScope = "https://www.googleapis.com/auth/analytics.readonly"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type DataGetCall

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

func (*DataGetCall) Context

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

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 (*DataGetCall) Dimensions

func (c *DataGetCall) Dimensions(dimensions string) *DataGetCall

Dimensions sets the optional parameter "dimensions": A comma-separated list of Analytics dimensions. E.g., 'ga:browser,ga:city'.

func (*DataGetCall) Do

func (c *DataGetCall) Do(opts ...googleapi.CallOption) error

Do executes the "analytics.data.get" call.

func (*DataGetCall) Fields

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

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

func (*DataGetCall) Filters

func (c *DataGetCall) Filters(filters string) *DataGetCall

Filters sets the optional parameter "filters": A comma-separated list of dimension or metric filters to be applied to the report data.

func (*DataGetCall) Header

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

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

func (*DataGetCall) IfNoneMatch

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

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 (*DataGetCall) MaxResults

func (c *DataGetCall) MaxResults(maxResults int64) *DataGetCall

MaxResults sets the optional parameter "max-results": The maximum number of entries to include in this feed.

func (*DataGetCall) Segment

func (c *DataGetCall) Segment(segment string) *DataGetCall

Segment sets the optional parameter "segment": An Analytics advanced segment to be applied to the report data.

func (*DataGetCall) Sort

func (c *DataGetCall) Sort(sort string) *DataGetCall

Sort sets the optional parameter "sort": A comma-separated list of dimensions or metrics that determine the sort order for the report data.

func (*DataGetCall) StartIndex

func (c *DataGetCall) StartIndex(startIndex int64) *DataGetCall

StartIndex sets the optional parameter "start-index": An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type DataService

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

func NewDataService

func NewDataService(s *Service) *DataService

func (*DataService) Get

func (r *DataService) Get(ids string, startDate string, endDate string, metrics string) *DataGetCall

Get: Returns Analytics report data for a view (profile).

type ManagementAccountsListCall

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

func (*ManagementAccountsListCall) Context

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 (*ManagementAccountsListCall) Do

Do executes the "analytics.management.accounts.list" call.

func (*ManagementAccountsListCall) Fields

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

func (*ManagementAccountsListCall) Header

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

func (*ManagementAccountsListCall) IfNoneMatch

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 (*ManagementAccountsListCall) MaxResults

func (c *ManagementAccountsListCall) MaxResults(maxResults int64) *ManagementAccountsListCall

MaxResults sets the optional parameter "max-results": The maximum number of accounts to include in this response.

func (*ManagementAccountsListCall) StartIndex

func (c *ManagementAccountsListCall) StartIndex(startIndex int64) *ManagementAccountsListCall

StartIndex sets the optional parameter "start-index": An index of the first account to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type ManagementAccountsService

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

func NewManagementAccountsService

func NewManagementAccountsService(s *Service) *ManagementAccountsService

func (*ManagementAccountsService) List

List: Lists all accounts to which the user has access.

type ManagementGoalsListCall

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

func (*ManagementGoalsListCall) Context

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 (*ManagementGoalsListCall) Do

Do executes the "analytics.management.goals.list" call.

func (*ManagementGoalsListCall) Fields

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

func (*ManagementGoalsListCall) Header

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

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

func (*ManagementGoalsListCall) IfNoneMatch

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

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 (*ManagementGoalsListCall) MaxResults

func (c *ManagementGoalsListCall) MaxResults(maxResults int64) *ManagementGoalsListCall

MaxResults sets the optional parameter "max-results": The maximum number of goals to include in this response.

func (*ManagementGoalsListCall) StartIndex

func (c *ManagementGoalsListCall) StartIndex(startIndex int64) *ManagementGoalsListCall

StartIndex sets the optional parameter "start-index": An index of the first goal to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type ManagementGoalsService

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

func NewManagementGoalsService

func NewManagementGoalsService(s *Service) *ManagementGoalsService

func (*ManagementGoalsService) List

func (r *ManagementGoalsService) List(accountId string, webPropertyId string, profileId string) *ManagementGoalsListCall

List: Lists goals to which the user has access.

type ManagementProfilesListCall

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

func (*ManagementProfilesListCall) Context

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 (*ManagementProfilesListCall) Do

Do executes the "analytics.management.profiles.list" call.

func (*ManagementProfilesListCall) Fields

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

func (*ManagementProfilesListCall) Header

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

func (*ManagementProfilesListCall) IfNoneMatch

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 (*ManagementProfilesListCall) MaxResults

func (c *ManagementProfilesListCall) MaxResults(maxResults int64) *ManagementProfilesListCall

MaxResults sets the optional parameter "max-results": The maximum number of views (profiles) to include in this response.

func (*ManagementProfilesListCall) StartIndex

func (c *ManagementProfilesListCall) StartIndex(startIndex int64) *ManagementProfilesListCall

StartIndex sets the optional parameter "start-index": An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type ManagementProfilesService

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

func NewManagementProfilesService

func NewManagementProfilesService(s *Service) *ManagementProfilesService

func (*ManagementProfilesService) List

func (r *ManagementProfilesService) List(accountId string, webPropertyId string) *ManagementProfilesListCall

List: Lists views (profiles) to which the user has access.

type ManagementSegmentsListCall

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

func (*ManagementSegmentsListCall) Context

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 (*ManagementSegmentsListCall) Do

Do executes the "analytics.management.segments.list" call.

func (*ManagementSegmentsListCall) Fields

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

func (*ManagementSegmentsListCall) Header

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

func (*ManagementSegmentsListCall) IfNoneMatch

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 (*ManagementSegmentsListCall) MaxResults

func (c *ManagementSegmentsListCall) MaxResults(maxResults int64) *ManagementSegmentsListCall

MaxResults sets the optional parameter "max-results": The maximum number of advanced segments to include in this response.

func (*ManagementSegmentsListCall) StartIndex

func (c *ManagementSegmentsListCall) StartIndex(startIndex int64) *ManagementSegmentsListCall

StartIndex sets the optional parameter "start-index": An index of the first advanced segment to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type ManagementSegmentsService

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

func NewManagementSegmentsService

func NewManagementSegmentsService(s *Service) *ManagementSegmentsService

func (*ManagementSegmentsService) List

List: Lists advanced segments to which the user has access.

type ManagementService

type ManagementService struct {
	Accounts *ManagementAccountsService

	Goals *ManagementGoalsService

	Profiles *ManagementProfilesService

	Segments *ManagementSegmentsService

	Webproperties *ManagementWebpropertiesService
	// contains filtered or unexported fields
}

func NewManagementService

func NewManagementService(s *Service) *ManagementService

type ManagementWebpropertiesListCall

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

func (*ManagementWebpropertiesListCall) Context

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 (*ManagementWebpropertiesListCall) Do

Do executes the "analytics.management.webproperties.list" call.

func (*ManagementWebpropertiesListCall) Fields

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

func (*ManagementWebpropertiesListCall) Header

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

func (*ManagementWebpropertiesListCall) IfNoneMatch

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 (*ManagementWebpropertiesListCall) MaxResults

MaxResults sets the optional parameter "max-results": The maximum number of web properties to include in this response.

func (*ManagementWebpropertiesListCall) StartIndex

StartIndex sets the optional parameter "start-index": An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

type ManagementWebpropertiesService

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

func NewManagementWebpropertiesService

func NewManagementWebpropertiesService(s *Service) *ManagementWebpropertiesService

func (*ManagementWebpropertiesService) List

List: Lists web properties to which the user has access.

type Service

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

	Data *DataService

	Management *ManagementService
	// contains filtered or unexported fields
}

func New deprecated

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 added in v0.3.0

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

NewService creates a new Service.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL