searchconsole

package
v0.177.0 Latest Latest
Warning

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

Go to latest
Published: Apr 30, 2024 License: BSD-3-Clause Imports: 16 Imported by: 9

Documentation

Overview

Package searchconsole provides access to the Google Search Console API.

For product documentation, see: https://developers.google.com/webmaster-tools/search-console-api/

Library status

These client libraries are officially supported by Google. However, this library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.

When possible, we recommend using our newer [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) that are still actively being worked and iterated on.

Creating a client

Usage example:

import "google.golang.org/api/searchconsole/v1"
...
ctx := context.Background()
searchconsoleService, err := searchconsole.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 google.golang.org/api/option.WithScopes:

searchconsoleService, err := searchconsole.NewService(ctx, option.WithScopes(searchconsole.WebmastersReadonlyScope))

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

searchconsoleService, err := searchconsole.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow, use google.golang.org/api/option.WithTokenSource:

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

See google.golang.org/api/option.ClientOption for details on options.

Index

Constants

View Source
const (
	// View and manage Search Console data for your verified sites
	WebmastersScope = "https://www.googleapis.com/auth/webmasters"

	// View Search Console data for your verified sites
	WebmastersReadonlyScope = "https://www.googleapis.com/auth/webmasters.readonly"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type AmpInspectionResult added in v0.67.0

type AmpInspectionResult struct {
	// AmpIndexStatusVerdict: Index status of the AMP URL.
	//
	// Possible values:
	//   "VERDICT_UNSPECIFIED" - Unknown verdict.
	//   "PASS" - Equivalent to "Valid" for the page or item in Search Console.
	//   "PARTIAL" - Reserved, no longer in use.
	//   "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in Search
	// Console.
	//   "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
	// Console.
	AmpIndexStatusVerdict string `json:"ampIndexStatusVerdict,omitempty"`
	// AmpUrl: URL of the AMP that was inspected. If the submitted URL is a desktop
	// page that refers to an AMP version, the AMP version will be inspected.
	AmpUrl string `json:"ampUrl,omitempty"`
	// IndexingState: Whether or not the page blocks indexing through a noindex
	// rule.
	//
	// Possible values:
	//   "AMP_INDEXING_STATE_UNSPECIFIED" - Unknown indexing status.
	//   "AMP_INDEXING_ALLOWED" - Indexing allowed.
	//   "BLOCKED_DUE_TO_NOINDEX" - Indexing not allowed, 'noindex' detected.
	//   "BLOCKED_DUE_TO_EXPIRED_UNAVAILABLE_AFTER" - Indexing not allowed,
	// 'unavailable_after' date expired.
	IndexingState string `json:"indexingState,omitempty"`
	// Issues: A list of zero or more AMP issues found for the inspected URL.
	Issues []*AmpIssue `json:"issues,omitempty"`
	// LastCrawlTime: Last time this AMP version was crawled by Google. Absent if
	// the URL was never crawled successfully.
	LastCrawlTime string `json:"lastCrawlTime,omitempty"`
	// PageFetchState: Whether or not Google could fetch the AMP.
	//
	// Possible values:
	//   "PAGE_FETCH_STATE_UNSPECIFIED" - Unknown fetch state.
	//   "SUCCESSFUL" - Successful fetch.
	//   "SOFT_404" - Soft 404.
	//   "BLOCKED_ROBOTS_TXT" - Blocked by robots.txt.
	//   "NOT_FOUND" - Not found (404).
	//   "ACCESS_DENIED" - Blocked due to unauthorized request (401).
	//   "SERVER_ERROR" - Server error (5xx).
	//   "REDIRECT_ERROR" - Redirection error.
	//   "ACCESS_FORBIDDEN" - Blocked due to access forbidden (403).
	//   "BLOCKED_4XX" - Blocked due to other 4xx issue (not 403, 404).
	//   "INTERNAL_CRAWL_ERROR" - Internal error.
	//   "INVALID_URL" - Invalid URL.
	PageFetchState string `json:"pageFetchState,omitempty"`
	// RobotsTxtState: Whether or not the page is blocked to Google by a robots.txt
	// rule.
	//
	// Possible values:
	//   "ROBOTS_TXT_STATE_UNSPECIFIED" - Unknown robots.txt state, typically
	// because the page wasn't fetched or found, or because robots.txt itself
	// couldn't be reached.
	//   "ALLOWED" - Crawl allowed by robots.txt.
	//   "DISALLOWED" - Crawl blocked by robots.txt.
	RobotsTxtState string `json:"robotsTxtState,omitempty"`
	// Verdict: The status of the most severe error on the page. If a page has both
	// warnings and errors, the page status is error. Error status means the page
	// cannot be shown in Search results.
	//
	// Possible values:
	//   "VERDICT_UNSPECIFIED" - Unknown verdict.
	//   "PASS" - Equivalent to "Valid" for the page or item in Search Console.
	//   "PARTIAL" - Reserved, no longer in use.
	//   "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in Search
	// Console.
	//   "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
	// Console.
	Verdict string `json:"verdict,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AmpIndexStatusVerdict") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AmpIndexStatusVerdict") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

AmpInspectionResult: AMP inspection result of the live page or the current information from Google's index, depending on whether you requested a live inspection or not.

func (*AmpInspectionResult) MarshalJSON added in v0.67.0

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

type AmpIssue added in v0.67.0

type AmpIssue struct {
	// IssueMessage: Brief description of this issue.
	IssueMessage string `json:"issueMessage,omitempty"`
	// Severity: Severity of this issue: WARNING or ERROR.
	//
	// Possible values:
	//   "SEVERITY_UNSPECIFIED" - Unknown severity.
	//   "WARNING" - Warning.
	//   "ERROR" - Error.
	Severity string `json:"severity,omitempty"`
	// ForceSendFields is a list of field names (e.g. "IssueMessage") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "IssueMessage") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

AmpIssue: AMP issue.

func (*AmpIssue) MarshalJSON added in v0.67.0

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

type ApiDataRow added in v0.33.0

type ApiDataRow struct {
	Clicks      float64  `json:"clicks,omitempty"`
	Ctr         float64  `json:"ctr,omitempty"`
	Impressions float64  `json:"impressions,omitempty"`
	Keys        []string `json:"keys,omitempty"`
	Position    float64  `json:"position,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Clicks") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Clicks") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (*ApiDataRow) MarshalJSON added in v0.33.0

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

func (*ApiDataRow) UnmarshalJSON added in v0.33.0

func (s *ApiDataRow) UnmarshalJSON(data []byte) error

type ApiDimensionFilter added in v0.33.0

type ApiDimensionFilter struct {
	// Possible values:
	//   "QUERY"
	//   "PAGE"
	//   "COUNTRY"
	//   "DEVICE"
	//   "SEARCH_APPEARANCE"
	Dimension  string `json:"dimension,omitempty"`
	Expression string `json:"expression,omitempty"`
	// Possible values:
	//   "EQUALS"
	//   "NOT_EQUALS"
	//   "CONTAINS"
	//   "NOT_CONTAINS"
	//   "INCLUDING_REGEX"
	//   "EXCLUDING_REGEX"
	Operator string `json:"operator,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Dimension") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Dimension") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ApiDimensionFilter: A filter test to be applied to each row in the data set, where a match can return the row. Filters are string comparisons, and values and dimension names are not case-sensitive. Individual filters are either AND'ed or OR'ed within their parent filter group, according to the group's group type. You do not need to group by a specified dimension to filter against it.

func (*ApiDimensionFilter) MarshalJSON added in v0.33.0

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

type ApiDimensionFilterGroup added in v0.33.0

type ApiDimensionFilterGroup struct {
	Filters []*ApiDimensionFilter `json:"filters,omitempty"`
	// Possible values:
	//   "AND"
	GroupType string `json:"groupType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Filters") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Filters") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ApiDimensionFilterGroup: A set of dimension value filters to test against each row. Only rows that pass all filter groups will be returned. All results within a filter group are either AND'ed or OR'ed together, depending on the group type selected. All filter groups are AND'ed together.

func (*ApiDimensionFilterGroup) MarshalJSON added in v0.33.0

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

type BlockedResource

type BlockedResource struct {
	// Url: URL of the blocked resource.
	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 or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	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. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

BlockedResource: Blocked resource.

func (*BlockedResource) MarshalJSON

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

type DetectedItems added in v0.67.0

type DetectedItems struct {
	// Items: List of Rich Results items.
	Items []*Item `json:"items,omitempty"`
	// RichResultType: Rich Results type
	RichResultType string `json:"richResultType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Items") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Items") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DetectedItems: Rich Results items grouped by type.

func (*DetectedItems) MarshalJSON added in v0.67.0

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

type Image

type Image struct {
	// Data: Image data in format determined by the mime type. Currently, the
	// format will always be "image/png", but this might change in the future.
	Data string `json:"data,omitempty"`
	// MimeType: The mime-type of the image data.
	MimeType string `json:"mimeType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Data") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Data") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Image: Describe image data.

func (*Image) MarshalJSON

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

type IndexStatusInspectionResult added in v0.67.0

type IndexStatusInspectionResult struct {
	// CoverageState: Could Google find and index the page. More details about page
	// indexing appear in 'indexing_state'.
	CoverageState string `json:"coverageState,omitempty"`
	// CrawledAs: Primary crawler that was used by Google to crawl your site.
	//
	// Possible values:
	//   "CRAWLING_USER_AGENT_UNSPECIFIED" - Unknown user agent.
	//   "DESKTOP" - Desktop user agent.
	//   "MOBILE" - Mobile user agent.
	CrawledAs string `json:"crawledAs,omitempty"`
	// GoogleCanonical: The URL of the page that Google selected as canonical. If
	// the page was not indexed, this field is absent.
	GoogleCanonical string `json:"googleCanonical,omitempty"`
	// IndexingState: Whether or not the page blocks indexing through a noindex
	// rule.
	//
	// Possible values:
	//   "INDEXING_STATE_UNSPECIFIED" - Unknown indexing status.
	//   "INDEXING_ALLOWED" - Indexing allowed.
	//   "BLOCKED_BY_META_TAG" - Indexing not allowed, 'noindex' detected in
	// 'robots' meta tag.
	//   "BLOCKED_BY_HTTP_HEADER" - Indexing not allowed, 'noindex' detected in
	// 'X-Robots-Tag' http header.
	//   "BLOCKED_BY_ROBOTS_TXT" - Reserved, no longer in use.
	IndexingState string `json:"indexingState,omitempty"`
	// LastCrawlTime: Last time this URL was crawled by Google using the primary
	// crawler
	// (https://support.google.com/webmasters/answer/7440203#primary_crawler).
	// Absent if the URL was never crawled successfully.
	LastCrawlTime string `json:"lastCrawlTime,omitempty"`
	// PageFetchState: Whether or not Google could retrieve the page from your
	// server. Equivalent to "page fetch"
	// (https://support.google.com/webmasters/answer/9012289#index_coverage) in the
	// URL inspection report.
	//
	// Possible values:
	//   "PAGE_FETCH_STATE_UNSPECIFIED" - Unknown fetch state.
	//   "SUCCESSFUL" - Successful fetch.
	//   "SOFT_404" - Soft 404.
	//   "BLOCKED_ROBOTS_TXT" - Blocked by robots.txt.
	//   "NOT_FOUND" - Not found (404).
	//   "ACCESS_DENIED" - Blocked due to unauthorized request (401).
	//   "SERVER_ERROR" - Server error (5xx).
	//   "REDIRECT_ERROR" - Redirection error.
	//   "ACCESS_FORBIDDEN" - Blocked due to access forbidden (403).
	//   "BLOCKED_4XX" - Blocked due to other 4xx issue (not 403, 404).
	//   "INTERNAL_CRAWL_ERROR" - Internal error.
	//   "INVALID_URL" - Invalid URL.
	PageFetchState string `json:"pageFetchState,omitempty"`
	// ReferringUrls: URLs that link to the inspected URL, directly and indirectly.
	ReferringUrls []string `json:"referringUrls,omitempty"`
	// RobotsTxtState: Whether or not the page is blocked to Google by a robots.txt
	// rule.
	//
	// Possible values:
	//   "ROBOTS_TXT_STATE_UNSPECIFIED" - Unknown robots.txt state, typically
	// because the page wasn't fetched or found, or because robots.txt itself
	// couldn't be reached.
	//   "ALLOWED" - Crawl allowed by robots.txt.
	//   "DISALLOWED" - Crawl blocked by robots.txt.
	RobotsTxtState string `json:"robotsTxtState,omitempty"`
	// Sitemap: Any sitemaps that this URL was listed in, as known by Google. Not
	// guaranteed to be an exhaustive list, especially if Google did not discover
	// this URL through a sitemap. Absent if no sitemaps were found.
	Sitemap []string `json:"sitemap,omitempty"`
	// UserCanonical: The URL that your page or site declares as canonical
	// (https://developers.google.com/search/docs/advanced/crawling/consolidate-duplicate-urls?#define-canonical).
	// If you did not declare a canonical URL, this field is absent.
	UserCanonical string `json:"userCanonical,omitempty"`
	// Verdict: High level verdict about whether the URL *is* indexed (indexed
	// status), or *can be* indexed (live inspection).
	//
	// Possible values:
	//   "VERDICT_UNSPECIFIED" - Unknown verdict.
	//   "PASS" - Equivalent to "Valid" for the page or item in Search Console.
	//   "PARTIAL" - Reserved, no longer in use.
	//   "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in Search
	// Console.
	//   "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
	// Console.
	Verdict string `json:"verdict,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CoverageState") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CoverageState") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

IndexStatusInspectionResult: Results of index status inspection for either the live page or the version in Google's index, depending on whether you requested a live inspection or not. For more information, see the Index coverage report documentation (https://support.google.com/webmasters/answer/7440203).

func (*IndexStatusInspectionResult) MarshalJSON added in v0.67.0

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

type InspectUrlIndexRequest added in v0.67.0

type InspectUrlIndexRequest struct {
	// InspectionUrl: Required. URL to inspect. Must be under the property
	// specified in "site_url".
	InspectionUrl string `json:"inspectionUrl,omitempty"`
	// LanguageCode: Optional. An IETF BCP-47
	// (https://en.wikipedia.org/wiki/IETF_language_tag) language code representing
	// the requested language for translated issue messages, e.g. "en-US", "or
	// "de-CH". Default value is "en-US".
	LanguageCode string `json:"languageCode,omitempty"`
	// SiteUrl: Required. The URL of the property as defined in Search Console.
	// **Examples:** `http://www.example.com/` for a URL-prefix property, or
	// `sc-domain:example.com` for a Domain property.
	SiteUrl string `json:"siteUrl,omitempty"`
	// ForceSendFields is a list of field names (e.g. "InspectionUrl") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "InspectionUrl") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

InspectUrlIndexRequest: Index inspection request.

func (*InspectUrlIndexRequest) MarshalJSON added in v0.67.0

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

type InspectUrlIndexResponse added in v0.67.0

type InspectUrlIndexResponse struct {
	// InspectionResult: URL inspection results.
	InspectionResult *UrlInspectionResult `json:"inspectionResult,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "InspectionResult") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "InspectionResult") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

InspectUrlIndexResponse: Index-Status inspection response.

func (*InspectUrlIndexResponse) MarshalJSON added in v0.67.0

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

type Item added in v0.67.0

type Item struct {
	// Issues: A list of zero or more rich result issues found for this instance.
	Issues []*RichResultsIssue `json:"issues,omitempty"`
	// Name: The user-provided name of this item.
	Name string `json:"name,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Issues") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Issues") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Item: A specific rich result found on the page.

func (*Item) MarshalJSON added in v0.67.0

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

type MobileFriendlyIssue

type MobileFriendlyIssue struct {
	// Rule: Rule violated.
	//
	// Possible values:
	//   "MOBILE_FRIENDLY_RULE_UNSPECIFIED" - Unknown rule. Sorry, we don't have
	// any description for the rule that was broken.
	//   "USES_INCOMPATIBLE_PLUGINS" - Plugins incompatible with mobile devices are
	// being used. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#flash_usage).
	//   "CONFIGURE_VIEWPORT" - Viewport is not specified using the meta viewport
	// tag. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#viewport_not_configured).
	//   "FIXED_WIDTH_VIEWPORT" - Viewport defined to a fixed width. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport).
	//   "SIZE_CONTENT_TO_VIEWPORT" - Content not sized to viewport. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport).
	//   "USE_LEGIBLE_FONT_SIZES" - Font size is too small for easy reading on a
	// small screen. [Learn More]
	// (https://support.google.com/webmasters/answer/6352293#small_font_size).
	//   "TAP_TARGETS_TOO_CLOSE" - Touch elements are too close to each other.
	// [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close).
	Rule string `json:"rule,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Rule") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Rule") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

MobileFriendlyIssue: Mobile-friendly issue.

func (*MobileFriendlyIssue) MarshalJSON

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

type MobileUsabilityInspectionResult added in v0.67.0

type MobileUsabilityInspectionResult struct {
	// Issues: A list of zero or more mobile-usability issues detected for this
	// URL.
	Issues []*MobileUsabilityIssue `json:"issues,omitempty"`
	// Verdict: High-level mobile-usability inspection result for this URL.
	//
	// Possible values:
	//   "VERDICT_UNSPECIFIED" - Unknown verdict.
	//   "PASS" - Equivalent to "Valid" for the page or item in Search Console.
	//   "PARTIAL" - Reserved, no longer in use.
	//   "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in Search
	// Console.
	//   "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
	// Console.
	Verdict string `json:"verdict,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Issues") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Issues") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

MobileUsabilityInspectionResult: Mobile-usability inspection results.

func (*MobileUsabilityInspectionResult) MarshalJSON added in v0.67.0

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

type MobileUsabilityIssue added in v0.67.0

type MobileUsabilityIssue struct {
	// IssueType: Mobile-usability issue type.
	//
	// Possible values:
	//   "MOBILE_USABILITY_ISSUE_TYPE_UNSPECIFIED" - Unknown issue. Sorry, we don't
	// have any description for the rule that was broken.
	//   "USES_INCOMPATIBLE_PLUGINS" - Plugins incompatible with mobile devices are
	// being used. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#flash_usage#error-list).
	//   "CONFIGURE_VIEWPORT" - Viewport is not specified using the meta viewport
	// tag. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#viewport_not_configured#error-list).
	//   "FIXED_WIDTH_VIEWPORT" - Viewport defined to a fixed width. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport#error-list).
	//   "SIZE_CONTENT_TO_VIEWPORT" - Content not sized to viewport. [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport#error-list).
	//   "USE_LEGIBLE_FONT_SIZES" - Font size is too small for easy reading on a
	// small screen. [Learn More]
	// (https://support.google.com/webmasters/answer/6352293#small_font_size#error-list).
	//   "TAP_TARGETS_TOO_CLOSE" - Touch elements are too close to each other.
	// [Learn more]
	// (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close#error-list).
	IssueType string `json:"issueType,omitempty"`
	// Message: Additional information regarding the issue.
	Message string `json:"message,omitempty"`
	// Severity: Not returned; reserved for future use.
	//
	// Possible values:
	//   "SEVERITY_UNSPECIFIED" - Unknown severity.
	//   "WARNING" - Warning.
	//   "ERROR" - Error.
	Severity string `json:"severity,omitempty"`
	// ForceSendFields is a list of field names (e.g. "IssueType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "IssueType") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

MobileUsabilityIssue: Mobile-usability issue.

func (*MobileUsabilityIssue) MarshalJSON added in v0.67.0

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

type ResourceIssue

type ResourceIssue struct {
	// BlockedResource: Describes a blocked resource issue.
	BlockedResource *BlockedResource `json:"blockedResource,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BlockedResource") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BlockedResource") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ResourceIssue: Information about a resource with issue.

func (*ResourceIssue) MarshalJSON

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

type RichResultsInspectionResult added in v0.67.0

type RichResultsInspectionResult struct {
	// DetectedItems: A list of zero or more rich results detected on this page.
	// Rich results that cannot even be parsed due to syntactic issues will not be
	// listed here.
	DetectedItems []*DetectedItems `json:"detectedItems,omitempty"`
	// Verdict: High-level rich results inspection result for this URL.
	//
	// Possible values:
	//   "VERDICT_UNSPECIFIED" - Unknown verdict.
	//   "PASS" - Equivalent to "Valid" for the page or item in Search Console.
	//   "PARTIAL" - Reserved, no longer in use.
	//   "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in Search
	// Console.
	//   "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
	// Console.
	Verdict string `json:"verdict,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DetectedItems") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DetectedItems") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RichResultsInspectionResult: Rich-Results inspection result, including any rich results found at this URL.

func (*RichResultsInspectionResult) MarshalJSON added in v0.67.0

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

type RichResultsIssue added in v0.67.0

type RichResultsIssue struct {
	// IssueMessage: Rich Results issue type.
	IssueMessage string `json:"issueMessage,omitempty"`
	// Severity: Severity of this issue: WARNING, or ERROR. Items with an issue of
	// status ERROR cannot appear with rich result features in Google Search
	// results.
	//
	// Possible values:
	//   "SEVERITY_UNSPECIFIED" - Unknown severity.
	//   "WARNING" - Warning.
	//   "ERROR" - Error.
	Severity string `json:"severity,omitempty"`
	// ForceSendFields is a list of field names (e.g. "IssueMessage") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "IssueMessage") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RichResultsIssue: Severity and status of a single issue affecting a single rich result instance on a page.

func (*RichResultsIssue) MarshalJSON added in v0.67.0

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

type RunMobileFriendlyTestRequest

type RunMobileFriendlyTestRequest struct {
	// RequestScreenshot: Whether or not screenshot is requested. Default is false.
	RequestScreenshot bool `json:"requestScreenshot,omitempty"`
	// Url: URL for inspection.
	Url string `json:"url,omitempty"`
	// ForceSendFields is a list of field names (e.g. "RequestScreenshot") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "RequestScreenshot") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RunMobileFriendlyTestRequest: Mobile-friendly test request.

func (*RunMobileFriendlyTestRequest) MarshalJSON

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

type RunMobileFriendlyTestResponse

type RunMobileFriendlyTestResponse struct {
	// MobileFriendliness: Test verdict, whether the page is mobile friendly or
	// not.
	//
	// Possible values:
	//   "MOBILE_FRIENDLY_TEST_RESULT_UNSPECIFIED" - Internal error when running
	// this test. Please try running the test again.
	//   "MOBILE_FRIENDLY" - The page is mobile friendly.
	//   "NOT_MOBILE_FRIENDLY" - The page is not mobile friendly.
	MobileFriendliness string `json:"mobileFriendliness,omitempty"`
	// MobileFriendlyIssues: List of mobile-usability issues.
	MobileFriendlyIssues []*MobileFriendlyIssue `json:"mobileFriendlyIssues,omitempty"`
	// ResourceIssues: Information about embedded resources issues.
	ResourceIssues []*ResourceIssue `json:"resourceIssues,omitempty"`
	// Screenshot: Screenshot of the requested URL.
	Screenshot *Image `json:"screenshot,omitempty"`
	// TestStatus: Final state of the test, can be either complete or an error.
	TestStatus *TestStatus `json:"testStatus,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "MobileFriendliness") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "MobileFriendliness") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RunMobileFriendlyTestResponse: Mobile-friendly test response, including mobile-friendly issues and resource issues.

func (*RunMobileFriendlyTestResponse) MarshalJSON

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

type SearchAnalyticsQueryRequest added in v0.33.0

type SearchAnalyticsQueryRequest struct {
	// AggregationType: [Optional; Default is \"auto\"] How data is aggregated. If
	// aggregated by property, all data for the same property is aggregated; if
	// aggregated by page, all data is aggregated by canonical URI. If you filter
	// or group by page, choose AUTO; otherwise you can aggregate either by
	// property or by page, depending on how you want your data calculated; see the
	// help documentation to learn how data is calculated differently by site
	// versus by page. **Note:** If you group or filter by page, you cannot
	// aggregate by property. If you specify any value other than AUTO, the
	// aggregation type in the result will match the requested type, or if you
	// request an invalid type, you will get an error. The API will never change
	// your aggregation type if the requested type is invalid.
	//
	// Possible values:
	//   "AUTO"
	//   "BY_PROPERTY"
	//   "BY_PAGE"
	//   "BY_NEWS_SHOWCASE_PANEL"
	AggregationType string `json:"aggregationType,omitempty"`
	// DataState: The data state to be fetched, can be full or all, the latter
	// including full and partial data.
	//
	// Possible values:
	//   "DATA_STATE_UNSPECIFIED" - Default value, should not be used.
	//   "FINAL" - Include full final data only, without partial.
	//   "ALL" - Include all data, full and partial.
	DataState string `json:"dataState,omitempty"`
	// DimensionFilterGroups: [Optional] Zero or more filters to apply to the
	// dimension grouping values; for example, 'query contains \"buy\"' to see only
	// data where the query string contains the substring \"buy\" (not
	// case-sensitive). You can filter by a dimension without grouping by it.
	DimensionFilterGroups []*ApiDimensionFilterGroup `json:"dimensionFilterGroups,omitempty"`
	// Dimensions: [Optional] Zero or more dimensions to group results by.
	// Dimensions are the group-by values in the Search Analytics page. Dimensions
	// are combined to create a unique row key for each row. Results are grouped in
	// the order that you supply these dimensions.
	//
	// Possible values:
	//   "DATE"
	//   "QUERY"
	//   "PAGE"
	//   "COUNTRY"
	//   "DEVICE"
	//   "SEARCH_APPEARANCE"
	Dimensions []string `json:"dimensions,omitempty"`
	// EndDate: [Required] End date of the requested date range, in YYYY-MM-DD
	// format, in PST (UTC - 8:00). Must be greater than or equal to the start
	// date. This value is included in the range.
	EndDate string `json:"endDate,omitempty"`
	// RowLimit: [Optional; Default is 1000] The maximum number of rows to return.
	// Must be a number from 1 to 25,000 (inclusive).
	RowLimit int64 `json:"rowLimit,omitempty"`
	// SearchType: [Optional; Default is \"web\"] The search type to filter for.
	//
	// Possible values:
	//   "WEB"
	//   "IMAGE"
	//   "VIDEO"
	//   "NEWS" - News tab in search.
	//   "DISCOVER" - Discover.
	//   "GOOGLE_NEWS" - Google News (news.google.com or mobile app).
	SearchType string `json:"searchType,omitempty"`
	// StartDate:  [Required] Start date of the requested date range, in YYYY-MM-DD
	// format, in PST time (UTC - 8:00). Must be less than or equal to the end
	// date. This value is included in the range.
	StartDate string `json:"startDate,omitempty"`
	// StartRow: [Optional; Default is 0] Zero-based index of the first row in the
	// response. Must be a non-negative number.
	StartRow int64 `json:"startRow,omitempty"`
	// Type: Optional. [Optional; Default is \"web\"] Type of report: search type,
	// or either Discover or Gnews.
	//
	// Possible values:
	//   "WEB"
	//   "IMAGE"
	//   "VIDEO"
	//   "NEWS" - News tab in search.
	//   "DISCOVER" - Discover.
	//   "GOOGLE_NEWS" - Google News (news.google.com or mobile app).
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AggregationType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AggregationType") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (*SearchAnalyticsQueryRequest) MarshalJSON added in v0.33.0

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

type SearchAnalyticsQueryResponse added in v0.33.0

type SearchAnalyticsQueryResponse struct {
	// ResponseAggregationType: How the results were aggregated.
	//
	// Possible values:
	//   "AUTO"
	//   "BY_PROPERTY"
	//   "BY_PAGE"
	//   "BY_NEWS_SHOWCASE_PANEL"
	ResponseAggregationType string `json:"responseAggregationType,omitempty"`
	// Rows: A list of rows grouped by the key values in the order given in the
	// query.
	Rows []*ApiDataRow `json:"rows,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "ResponseAggregationType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ResponseAggregationType") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SearchAnalyticsQueryResponse: A list of rows, one per result, grouped by key. Metrics in each row are aggregated for all data grouped by that key either by page or property, as specified by the aggregation type parameter.

func (*SearchAnalyticsQueryResponse) MarshalJSON added in v0.33.0

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

type SearchanalyticsQueryCall added in v0.33.0

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

func (*SearchanalyticsQueryCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SearchanalyticsQueryCall) Do added in v0.33.0

Do executes the "webmasters.searchanalytics.query" call. Any non-2xx status code is an error. Response headers are in either *SearchAnalyticsQueryResponse.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 (*SearchanalyticsQueryCall) Fields added in v0.33.0

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

func (*SearchanalyticsQueryCall) Header added in v0.33.0

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

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

type SearchanalyticsService added in v0.33.0

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

func NewSearchanalyticsService added in v0.33.0

func NewSearchanalyticsService(s *Service) *SearchanalyticsService

func (*SearchanalyticsService) Query added in v0.33.0

func (r *SearchanalyticsService) Query(siteUrl string, searchanalyticsqueryrequest *SearchAnalyticsQueryRequest) *SearchanalyticsQueryCall

Query: Query your data with filters and parameters that you define. Returns zero or more rows grouped by the row keys that you define. You must define a date range of one or more days. When date is one of the group by values, any days without data are omitted from the result list. If you need to know which days have data, issue a broad date range query grouped by date for any metric, and see which day rows are returned.

type Service

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

	Searchanalytics *SearchanalyticsService

	Sitemaps *SitemapsService

	Sites *SitesService

	UrlInspection *UrlInspectionService

	UrlTestingTools *UrlTestingToolsService
	// 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.

type SitemapsDeleteCall added in v0.33.0

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

func (*SitemapsDeleteCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SitemapsDeleteCall) Do added in v0.33.0

Do executes the "webmasters.sitemaps.delete" call.

func (*SitemapsDeleteCall) Fields added in v0.33.0

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

func (*SitemapsDeleteCall) Header added in v0.33.0

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

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

type SitemapsGetCall added in v0.33.0

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

func (*SitemapsGetCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SitemapsGetCall) Do added in v0.33.0

Do executes the "webmasters.sitemaps.get" call. Any non-2xx status code is an error. Response headers are in either *WmxSitemap.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 (*SitemapsGetCall) Fields added in v0.33.0

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

func (*SitemapsGetCall) Header added in v0.33.0

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

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

func (*SitemapsGetCall) IfNoneMatch added in v0.33.0

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

IfNoneMatch sets an 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.

type SitemapsListCall added in v0.33.0

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

func (*SitemapsListCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SitemapsListCall) Do added in v0.33.0

Do executes the "webmasters.sitemaps.list" call. Any non-2xx status code is an error. Response headers are in either *SitemapsListResponse.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 (*SitemapsListCall) Fields added in v0.33.0

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

func (*SitemapsListCall) Header added in v0.33.0

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

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

func (*SitemapsListCall) IfNoneMatch added in v0.33.0

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

IfNoneMatch sets an 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.

func (*SitemapsListCall) SitemapIndex added in v0.33.0

func (c *SitemapsListCall) SitemapIndex(sitemapIndex string) *SitemapsListCall

SitemapIndex sets the optional parameter "sitemapIndex": A URL of a site's sitemap index. For example: `http://www.example.com/sitemapindex.xml`.

type SitemapsListResponse added in v0.33.0

type SitemapsListResponse struct {
	// Sitemap: Contains detailed information about a specific URL submitted as a
	// sitemap (https://support.google.com/webmasters/answer/156184).
	Sitemap []*WmxSitemap `json:"sitemap,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Sitemap") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Sitemap") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SitemapsListResponse: List of sitemaps.

func (*SitemapsListResponse) MarshalJSON added in v0.33.0

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

type SitemapsService added in v0.33.0

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

func NewSitemapsService added in v0.33.0

func NewSitemapsService(s *Service) *SitemapsService

func (*SitemapsService) Delete added in v0.33.0

func (r *SitemapsService) Delete(siteUrl string, feedpath string) *SitemapsDeleteCall

Delete: Deletes a sitemap from the Sitemaps report. Does not stop Google from crawling this sitemap or the URLs that were previously crawled in the deleted sitemap.

func (*SitemapsService) Get added in v0.33.0

func (r *SitemapsService) Get(siteUrl string, feedpath string) *SitemapsGetCall

Get: Retrieves information about a specific sitemap.

func (*SitemapsService) List added in v0.33.0

func (r *SitemapsService) List(siteUrl string) *SitemapsListCall

List: Lists the sitemaps-entries (/webmaster-tools/v3/sitemaps) submitted for this site, or included in the sitemap index file (if `sitemapIndex` is specified in the request).

func (*SitemapsService) Submit added in v0.33.0

func (r *SitemapsService) Submit(siteUrl string, feedpath string) *SitemapsSubmitCall

Submit: Submits a sitemap for a site.

type SitemapsSubmitCall added in v0.33.0

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

func (*SitemapsSubmitCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SitemapsSubmitCall) Do added in v0.33.0

Do executes the "webmasters.sitemaps.submit" call.

func (*SitemapsSubmitCall) Fields added in v0.33.0

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

func (*SitemapsSubmitCall) Header added in v0.33.0

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

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

type SitesAddCall added in v0.33.0

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

func (*SitesAddCall) Context added in v0.33.0

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

Context sets the context to be used in this call's Do method.

func (*SitesAddCall) Do added in v0.33.0

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

Do executes the "webmasters.sites.add" call.

func (*SitesAddCall) Fields added in v0.33.0

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

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

func (*SitesAddCall) Header added in v0.33.0

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

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

type SitesDeleteCall added in v0.33.0

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

func (*SitesDeleteCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*SitesDeleteCall) Do added in v0.33.0

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

Do executes the "webmasters.sites.delete" call.

func (*SitesDeleteCall) Fields added in v0.33.0

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

func (*SitesDeleteCall) Header added in v0.33.0

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

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

type SitesGetCall added in v0.33.0

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

func (*SitesGetCall) Context added in v0.33.0

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

Context sets the context to be used in this call's Do method.

func (*SitesGetCall) Do added in v0.33.0

func (c *SitesGetCall) Do(opts ...googleapi.CallOption) (*WmxSite, error)

Do executes the "webmasters.sites.get" call. Any non-2xx status code is an error. Response headers are in either *WmxSite.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 (*SitesGetCall) Fields added in v0.33.0

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

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

func (*SitesGetCall) Header added in v0.33.0

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

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

func (*SitesGetCall) IfNoneMatch added in v0.33.0

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

IfNoneMatch sets an 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.

type SitesListCall added in v0.33.0

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

func (*SitesListCall) Context added in v0.33.0

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

Context sets the context to be used in this call's Do method.

func (*SitesListCall) Do added in v0.33.0

Do executes the "webmasters.sites.list" call. Any non-2xx status code is an error. Response headers are in either *SitesListResponse.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 (*SitesListCall) Fields added in v0.33.0

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

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

func (*SitesListCall) Header added in v0.33.0

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

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

func (*SitesListCall) IfNoneMatch added in v0.33.0

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

IfNoneMatch sets an 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.

type SitesListResponse added in v0.33.0

type SitesListResponse struct {
	// SiteEntry: Contains permission level information about a Search Console
	// site. For more information, see Permissions in Search Console
	// (https://support.google.com/webmasters/answer/2451999).
	SiteEntry []*WmxSite `json:"siteEntry,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "SiteEntry") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "SiteEntry") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SitesListResponse: List of sites with access level information.

func (*SitesListResponse) MarshalJSON added in v0.33.0

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

type SitesService added in v0.33.0

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

func NewSitesService added in v0.33.0

func NewSitesService(s *Service) *SitesService

func (*SitesService) Add added in v0.33.0

func (r *SitesService) Add(siteUrl string) *SitesAddCall

Add: Adds a site to the set of the user's sites in Search Console.

- siteUrl: The URL of the site to add.

func (*SitesService) Delete added in v0.33.0

func (r *SitesService) Delete(siteUrl string) *SitesDeleteCall

Delete: Removes a site from the set of the user's Search Console sites.

  • siteUrl: The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.

func (*SitesService) Get added in v0.33.0

func (r *SitesService) Get(siteUrl string) *SitesGetCall

Get: Retrieves information about specific site.

  • siteUrl: The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.

func (*SitesService) List added in v0.33.0

func (r *SitesService) List() *SitesListCall

List: Lists the user's Search Console sites.

type TestStatus

type TestStatus struct {
	// Details: Error details if applicable.
	Details string `json:"details,omitempty"`
	// Status: Status of the test.
	//
	// Possible values:
	//   "TEST_STATUS_UNSPECIFIED" - Internal error when running this test. Please
	// try running the test again.
	//   "COMPLETE" - Inspection has completed without errors.
	//   "INTERNAL_ERROR" - Inspection terminated in an error state. This indicates
	// a problem in Google's infrastructure, not a user error. Please try again
	// later.
	//   "PAGE_UNREACHABLE" - Google can not access the URL because of a user error
	// such as a robots.txt blockage, a 403 or 500 code etc. Please make sure that
	// the URL provided is accessible by Googlebot and is not password protected.
	Status string `json:"status,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Details") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Details") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TestStatus: Final state of the test, including error details if necessary.

func (*TestStatus) MarshalJSON

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

type UrlInspectionIndexInspectCall added in v0.67.0

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

func (*UrlInspectionIndexInspectCall) Context added in v0.67.0

Context sets the context to be used in this call's Do method.

func (*UrlInspectionIndexInspectCall) Do added in v0.67.0

Do executes the "searchconsole.urlInspection.index.inspect" call. Any non-2xx status code is an error. Response headers are in either *InspectUrlIndexResponse.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 (*UrlInspectionIndexInspectCall) Fields added in v0.67.0

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

func (*UrlInspectionIndexInspectCall) Header added in v0.67.0

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

type UrlInspectionIndexService added in v0.67.0

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

func NewUrlInspectionIndexService added in v0.67.0

func NewUrlInspectionIndexService(s *Service) *UrlInspectionIndexService

func (*UrlInspectionIndexService) Inspect added in v0.67.0

Inspect: Index inspection.

type UrlInspectionResult added in v0.67.0

type UrlInspectionResult struct {
	// AmpResult: Result of the AMP analysis. Absent if the page is not an AMP
	// page.
	AmpResult *AmpInspectionResult `json:"ampResult,omitempty"`
	// IndexStatusResult: Result of the index status analysis.
	IndexStatusResult *IndexStatusInspectionResult `json:"indexStatusResult,omitempty"`
	// InspectionResultLink: Link to Search Console URL inspection.
	InspectionResultLink string `json:"inspectionResultLink,omitempty"`
	// MobileUsabilityResult: Result of the Mobile usability analysis.
	MobileUsabilityResult *MobileUsabilityInspectionResult `json:"mobileUsabilityResult,omitempty"`
	// RichResultsResult: Result of the Rich Results analysis. Absent if there are
	// no rich results found.
	RichResultsResult *RichResultsInspectionResult `json:"richResultsResult,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AmpResult") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AmpResult") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

UrlInspectionResult: URL inspection result, including all inspection results.

func (*UrlInspectionResult) MarshalJSON added in v0.67.0

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

type UrlInspectionService added in v0.67.0

type UrlInspectionService struct {
	Index *UrlInspectionIndexService
	// contains filtered or unexported fields
}

func NewUrlInspectionService added in v0.67.0

func NewUrlInspectionService(s *Service) *UrlInspectionService

type UrlTestingToolsMobileFriendlyTestRunCall

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

func (*UrlTestingToolsMobileFriendlyTestRunCall) Context

Context sets the context to be used in this call's Do method.

func (*UrlTestingToolsMobileFriendlyTestRunCall) Do

Do executes the "searchconsole.urlTestingTools.mobileFriendlyTest.run" call. Any non-2xx status code is an error. Response headers are in either *RunMobileFriendlyTestResponse.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 (*UrlTestingToolsMobileFriendlyTestRunCall) Fields

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

func (*UrlTestingToolsMobileFriendlyTestRunCall) Header

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

type UrlTestingToolsMobileFriendlyTestService

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

func NewUrlTestingToolsMobileFriendlyTestService

func NewUrlTestingToolsMobileFriendlyTestService(s *Service) *UrlTestingToolsMobileFriendlyTestService

func (*UrlTestingToolsMobileFriendlyTestService) Run

Run: Runs Mobile-Friendly Test for a given URL.

type UrlTestingToolsService

type UrlTestingToolsService struct {
	MobileFriendlyTest *UrlTestingToolsMobileFriendlyTestService
	// contains filtered or unexported fields
}

func NewUrlTestingToolsService

func NewUrlTestingToolsService(s *Service) *UrlTestingToolsService

type WmxSite added in v0.33.0

type WmxSite struct {
	// PermissionLevel: The user's permission level for the site.
	//
	// Possible values:
	//   "SITE_PERMISSION_LEVEL_UNSPECIFIED"
	//   "SITE_OWNER" - Owner has complete access to the site.
	//   "SITE_FULL_USER" - Full users can access all data, and perform most of the
	// operations.
	//   "SITE_RESTRICTED_USER" - Restricted users can access most of the data, and
	// perform some operations.
	//   "SITE_UNVERIFIED_USER" - Unverified user has no access to site's data.
	PermissionLevel string `json:"permissionLevel,omitempty"`
	// SiteUrl: The URL of the site.
	SiteUrl string `json:"siteUrl,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "PermissionLevel") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "PermissionLevel") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

WmxSite: Contains permission level information about a Search Console site. For more information, see Permissions in Search Console (https://support.google.com/webmasters/answer/2451999).

func (*WmxSite) MarshalJSON added in v0.33.0

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

type WmxSitemap added in v0.33.0

type WmxSitemap struct {
	// Contents: The various content types in the sitemap.
	Contents []*WmxSitemapContent `json:"contents,omitempty"`
	// Errors: Number of errors in the sitemap. These are issues with the sitemap
	// itself that need to be fixed before it can be processed correctly.
	Errors int64 `json:"errors,omitempty,string"`
	// IsPending: If true, the sitemap has not been processed.
	IsPending bool `json:"isPending,omitempty"`
	// IsSitemapsIndex: If true, the sitemap is a collection of sitemaps.
	IsSitemapsIndex bool `json:"isSitemapsIndex,omitempty"`
	// LastDownloaded: Date & time in which this sitemap was last downloaded. Date
	// format is in RFC 3339 format (yyyy-mm-dd).
	LastDownloaded string `json:"lastDownloaded,omitempty"`
	// LastSubmitted: Date & time in which this sitemap was submitted. Date format
	// is in RFC 3339 format (yyyy-mm-dd).
	LastSubmitted string `json:"lastSubmitted,omitempty"`
	// Path: The url of the sitemap.
	Path string `json:"path,omitempty"`
	// Type: The type of the sitemap. For example: `rssFeed`.
	//
	// Possible values:
	//   "NOT_SITEMAP"
	//   "URL_LIST"
	//   "SITEMAP"
	//   "RSS_FEED"
	//   "ATOM_FEED"
	//   "PATTERN_SITEMAP" - Unsupported sitemap types.
	//   "OCEANFRONT"
	Type string `json:"type,omitempty"`
	// Warnings: Number of warnings for the sitemap. These are generally
	// non-critical issues with URLs in the sitemaps.
	Warnings int64 `json:"warnings,omitempty,string"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Contents") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Contents") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

WmxSitemap: Contains detailed information about a specific URL submitted as a sitemap (https://support.google.com/webmasters/answer/156184).

func (*WmxSitemap) MarshalJSON added in v0.33.0

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

type WmxSitemapContent added in v0.33.0

type WmxSitemapContent struct {
	// Indexed: *Deprecated; do not use.*
	Indexed int64 `json:"indexed,omitempty,string"`
	// Submitted: The number of URLs in the sitemap (of the content type).
	Submitted int64 `json:"submitted,omitempty,string"`
	// Type: The specific type of content in this sitemap. For example: `web`.
	//
	// Possible values:
	//   "WEB"
	//   "IMAGE"
	//   "VIDEO"
	//   "NEWS"
	//   "MOBILE"
	//   "ANDROID_APP"
	//   "PATTERN" - Unsupported content type.
	//   "IOS_APP"
	//   "DATA_FEED_ELEMENT" - Unsupported content type.
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Indexed") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Indexed") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

WmxSitemapContent: Information about the various content types in the sitemap.

func (*WmxSitemapContent) MarshalJSON added in v0.33.0

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

Jump to

Keyboard shortcuts

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