curl 'https://www.google.com/ping?sitemap=https://example.com/path/to/sitemap.xml'

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 (r *SitesService) List() *SitesListCall

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

func (c *SitesListCall) Do(opts ...googleapi.CallOption) (*SitesListResponse, error)

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

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

package main

import (
	"log"
	"fmt"
	"context"
	"google.golang.org/api/searchconsole/v1"
)

func main() {
	// Will rely on e.g. environ's GOOGLE_APPLICATION_CREDENTIALS
	// to find the credential file
	scs, err := searchconsole.NewService(context.Background())
	if err != nil {
		log.Fatal(err)
	}

	slr, err := scs.Sites.List().Do()
	if err != nil {
		log.Fatal(err)
	}
	for _, e := range slr.SiteEntry {
		fmt.Println(e.SiteUrl)
	}
}

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

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

package main

import (
	"log"
	"fmt"
	"time"
	"os"
	"path"
	"context"
	"google.golang.org/api/searchconsole/v1"
)

// YYYY-MM-DD format for time.Parse()/.Format()
var YYYYMMDD = "2006-01-02"

// last day for which we had clicks
func getLastDay(xs []*searchconsole.ApiDataRow) (string, error) {
	n := time.Now().UTC().AddDate(-20, 0, 0)

	for _, x := range xs {
		if x.Clicks == 0 {
			continue
		}
		if len(x.Keys) == 0 {
			return "", fmt.Errorf("Empty Keys")
		}
		d, err := time.Parse(YYYYMMDD , x.Keys[0])
		if err != nil {
			return "", fmt.Errorf("First Keys element is not an YYYY-MM-DD: %s", x.Keys[0])
		}

		if d.After(n) {
			n = d
		}
	}
	return n.Format(YYYYMMDD), nil
}

func printHeader(xs []*searchconsole.ApiDataRow, last string) {
	nc := 0
	ni := 0
	for _, x := range xs {
		// NOTE: always there, cf. getLastDay()
		if x.Keys[0] != last {
			continue
		}
		nc += int(x.Clicks)
		ni += int(x.Impressions)
	}
	// NOTE: averaging the x.Ctr yields a result discordant
	// with what's displayed on the Web Console; likely
	// an accumulation of rounding errors. This is much closer:
	ct := float64(nc)/float64(ni)
	fmt.Printf("----------------------------------\n")
	fmt.Printf("%-10s %-10s %-5s %s\n", "Clicks", "Impr.", "Ctr.", "Pages")
	fmt.Printf("%-10d %-10d %-5.2f %s\n", nc, ni, ct*100, "Total")
	fmt.Printf("----------------------------------\n")
}

func queryLastAnalytics(scs *searchconsole.Service, s string) error {
	n := time.Now().UTC()

	// 10 days ago should be good enough; stats are usually
	// updated in less than a day, around 2d before today
	args := searchconsole.SearchAnalyticsQueryRequest{
		Dimensions : []string{"DATE", "PAGE"},
		StartDate  : n.AddDate(0, 0, -10).Format(YYYYMMDD),
		EndDate    : n.Format(YYYYMMDD),
		DataState  : "ALL",
	}

	saqr, err := scs.Searchanalytics.Query(s, &args).Do()
	if err != nil {
		return err
	}

	// shortcut
	xs := saqr.Rows

	last, err := getLastDay(xs)
	if err != nil {
		return err
	}

	fmt.Printf("----------------------------------\n")
	fmt.Printf("Last day: %s\n", last)
	printHeader(xs, last)
	for _, x := range xs {
		// NOTE: always there, cf. getLastDay()
		if x.Keys[0] != last {
			continue
		}
		fmt.Printf("%-10d %-10d %-5.2f %s\n", int(x.Clicks), int(x.Impressions), x.Ctr*100, x.Keys[1])
	}

	return nil
}

func main() {
	// Will rely on e.g. environ's GOOGLE_APPLICATION_CREDENTIALS
	// to find the credential file
	scs, err := searchconsole.NewService(context.Background())
	if err != nil {
		log.Fatal(err)
	}

	if len(os.Args) < 2 {
		log.Fatalf("%s <site>", path.Base(os.Args[0]))
	}
	if queryLastAnalytics(scs, os.Args[1]); err != nil {
		log.Fatal(err)
	}
}

type ApiDimensionFilterGroup struct {
	Filters []*ApiDimensionFilter `json:"filters,omitempty"`

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

/* Other main type of interest to us: */

type ApiDimensionFilter struct {
	Dimension string `json:"dimension,omitempty"`

	Expression string `json:"expression,omitempty"`

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

package main

import (
	"log"
	"fmt"
	"time"
	"os"
	"path"
	"context"
	"strings"
	"google.golang.org/api/searchconsole/v1"
)

// YYYY-MM-DD format for time.Parse()/.Format()
var YYYYMMDD = "2006-01-02"

func printHeader(xs []*searchconsole.ApiDataRow, last string) {
	nc := 0
	ni := 0
	for _, x := range xs {
		// NOTE: always there, cf. getLastDay()
		if x.Keys[0] != last {
			continue
		}
		nc += int(x.Clicks)
		ni += int(x.Impressions)
	}
	// NOTE: averaging the x.Ctr yields a result discordant
	// with what's displayed on the Web Console; likely
	// an accumulation of rounding errors. This is much closer:
	ct := float64(nc)/float64(ni)
	fmt.Printf("----------------------------------\n")
	fmt.Printf("%-10s %-10s %-5s %s\n", "Clicks", "Impr.", "Ctr.", "Keywords")
	fmt.Printf("%-10d %-10d %-5.2f %s\n", nc, ni, ct*100, "Total")
	fmt.Printf("----------------------------------\n")
}

func queryKeywordsFull(scs *searchconsole.Service, s, p string) error {
	n := time.Now().UTC()

	// Flexible input
	s = strings.TrimRight(s, "/")
	if p == "" || p[0] != '/' {
		p = "/" + p
	}

	args := searchconsole.SearchAnalyticsQueryRequest{
		Dimensions : []string{"QUERY"},
		DimensionFilterGroups : []*searchconsole.ApiDimensionFilterGroup{
			&searchconsole.ApiDimensionFilterGroup{
				Filters : []*searchconsole.ApiDimensionFilter{
					&searchconsole.ApiDimensionFilter {
						Dimension  : "page",
						Operator   : "equals",
						Expression : s+p,
					},
				},
			},
		},
		// 20 *years* ago
		StartDate  : n.AddDate(-20, 0, 0).Format(YYYYMMDD),
		EndDate    : n.Format(YYYYMMDD),
		DataState  : "ALL",
	}

	saqr, err := scs.Searchanalytics.Query(s, &args).Do()
	if err != nil {
		return err
	}

	xs := saqr.Rows
	fmt.Printf("----------------------------------\n")
	fmt.Printf("Page: %s\n", p)
	printHeader(xs, "")
	for _, x := range xs {
		fmt.Printf(
			"%-10d %-10d %-5.2f %s\n",
			int(x.Clicks),
			int(x.Impressions),
			x.Ctr*100,
			x.Keys[0],
		)
	}

	return nil
}

func main() {
	// Will rely on e.g. environ's GOOGLE_APPLICATION_CREDENTIALS
	// to find the credential file
	scs, err := searchconsole.NewService(context.Background())
	if err != nil {
		log.Fatal(err)
	}

	if len(os.Args) < 3 {
		log.Fatalf("%s <site> <page>", path.Base(os.Args[0]))
	}
	if queryKeywordsFull(scs, os.Args[1], os.Args[2]); err != nil {
		log.Fatal(err)
	}
}

	$ GOOS=android GOARCH=arm64 go build -o /tmp/search-console search-console.go

	# You'll want to install those e.g. in termux's $HOME somehow;
	# having a sh(1) wrapper to wrap common options can be convenient
	# too
	$ adb push /tmp/search-console        /storage/XXXX-XXXX/
	$ adb push $HOME/.search-console.json /storage/XXXX-XXXX/

import (
	...
	"runtime"
	"net"
	...
)
	...
	if runtime.GOOS == "android" {
		var dialer net.Dialer
		net.DefaultResolver = &net.Resolver{
			PreferGo: false,
			Dial: func(context context.Context, _, _ string) (net.Conn, error) {
				conn, err := dialer.DialContext(context, "udp", "1.1.1.1:53")
				if err != nil {
					return nil, err
				}
				return conn, nil
			},
		}
	}
	...