357 lines
11 KiB
Go
357 lines
11 KiB
Go
// Package pagespeedonline provides access to the PageSpeed Insights API.
|
|
//
|
|
// See https://developers.google.com/speed/docs/insights/v1/getting_started
|
|
//
|
|
// Usage example:
|
|
//
|
|
// import "google.golang.org/api/pagespeedonline/v1"
|
|
// ...
|
|
// pagespeedonlineService, err := pagespeedonline.New(oauthHttpClient)
|
|
package pagespeedonline
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"google.golang.org/api/googleapi"
|
|
"io"
|
|
"net/http"
|
|
"net/url"
|
|
"strconv"
|
|
"strings"
|
|
)
|
|
|
|
// Always reference these packages, just in case the auto-generated code
|
|
// below doesn't.
|
|
var _ = bytes.NewBuffer
|
|
var _ = strconv.Itoa
|
|
var _ = fmt.Sprintf
|
|
var _ = json.NewDecoder
|
|
var _ = io.Copy
|
|
var _ = url.Parse
|
|
var _ = googleapi.Version
|
|
var _ = errors.New
|
|
var _ = strings.Replace
|
|
|
|
const apiId = "pagespeedonline:v1"
|
|
const apiName = "pagespeedonline"
|
|
const apiVersion = "v1"
|
|
const basePath = "https://www.googleapis.com/pagespeedonline/v1/"
|
|
|
|
func New(client *http.Client) (*Service, error) {
|
|
if client == nil {
|
|
return nil, errors.New("client is nil")
|
|
}
|
|
s := &Service{client: client, BasePath: basePath}
|
|
s.Pagespeedapi = NewPagespeedapiService(s)
|
|
return s, nil
|
|
}
|
|
|
|
type Service struct {
|
|
client *http.Client
|
|
BasePath string // API endpoint base URL
|
|
|
|
Pagespeedapi *PagespeedapiService
|
|
}
|
|
|
|
func NewPagespeedapiService(s *Service) *PagespeedapiService {
|
|
rs := &PagespeedapiService{s: s}
|
|
return rs
|
|
}
|
|
|
|
type PagespeedapiService struct {
|
|
s *Service
|
|
}
|
|
|
|
type Result struct {
|
|
// FormattedResults: Localized Page Speed results. Contains a
|
|
// ruleResults entry for each Page Speed rule instantiated and run by
|
|
// the server.
|
|
FormattedResults *ResultFormattedResults `json:"formattedResults,omitempty"`
|
|
|
|
// Id: Canonicalized and final URL for the document, after following
|
|
// page redirects (if any).
|
|
Id string `json:"id,omitempty"`
|
|
|
|
// InvalidRules: List of rules that were specified in the request, but
|
|
// which the server did not know how to instantiate.
|
|
InvalidRules []string `json:"invalidRules,omitempty"`
|
|
|
|
// Kind: Kind of result.
|
|
Kind string `json:"kind,omitempty"`
|
|
|
|
// PageStats: Summary statistics for the page, such as number of
|
|
// JavaScript bytes, number of HTML bytes, etc.
|
|
PageStats *ResultPageStats `json:"pageStats,omitempty"`
|
|
|
|
// ResponseCode: Response code for the document. 200 indicates a normal
|
|
// page load. 4xx/5xx indicates an error.
|
|
ResponseCode int64 `json:"responseCode,omitempty"`
|
|
|
|
// Score: The Page Speed Score (0-100), which indicates how much faster
|
|
// a page could be. A high score indicates little room for improvement,
|
|
// while a lower score indicates more room for improvement.
|
|
Score int64 `json:"score,omitempty"`
|
|
|
|
// Screenshot: Base64 encoded screenshot of the page that was analyzed.
|
|
Screenshot *ResultScreenshot `json:"screenshot,omitempty"`
|
|
|
|
// Title: Title of the page, as displayed in the browser's title bar.
|
|
Title string `json:"title,omitempty"`
|
|
|
|
// Version: The version of the Page Speed SDK used to generate these
|
|
// results.
|
|
Version *ResultVersion `json:"version,omitempty"`
|
|
}
|
|
|
|
type ResultFormattedResults struct {
|
|
// Locale: The locale of the formattedResults, e.g. "en_US".
|
|
Locale string `json:"locale,omitempty"`
|
|
|
|
// RuleResults: Dictionary of formatted rule results, with one entry for
|
|
// each Page Speed rule instantiated and run by the server.
|
|
RuleResults *ResultFormattedResultsRuleResults `json:"ruleResults,omitempty"`
|
|
}
|
|
|
|
type ResultFormattedResultsRuleResults struct {
|
|
}
|
|
|
|
type ResultPageStats struct {
|
|
// CssResponseBytes: Number of uncompressed response bytes for CSS
|
|
// resources on the page.
|
|
CssResponseBytes int64 `json:"cssResponseBytes,omitempty,string"`
|
|
|
|
// FlashResponseBytes: Number of response bytes for flash resources on
|
|
// the page.
|
|
FlashResponseBytes int64 `json:"flashResponseBytes,omitempty,string"`
|
|
|
|
// HtmlResponseBytes: Number of uncompressed response bytes for the main
|
|
// HTML document and all iframes on the page.
|
|
HtmlResponseBytes int64 `json:"htmlResponseBytes,omitempty,string"`
|
|
|
|
// ImageResponseBytes: Number of response bytes for image resources on
|
|
// the page.
|
|
ImageResponseBytes int64 `json:"imageResponseBytes,omitempty,string"`
|
|
|
|
// JavascriptResponseBytes: Number of uncompressed response bytes for JS
|
|
// resources on the page.
|
|
JavascriptResponseBytes int64 `json:"javascriptResponseBytes,omitempty,string"`
|
|
|
|
// NumberCssResources: Number of CSS resources referenced by the page.
|
|
NumberCssResources int64 `json:"numberCssResources,omitempty"`
|
|
|
|
// NumberHosts: Number of unique hosts referenced by the page.
|
|
NumberHosts int64 `json:"numberHosts,omitempty"`
|
|
|
|
// NumberJsResources: Number of JavaScript resources referenced by the
|
|
// page.
|
|
NumberJsResources int64 `json:"numberJsResources,omitempty"`
|
|
|
|
// NumberResources: Number of HTTP resources loaded by the page.
|
|
NumberResources int64 `json:"numberResources,omitempty"`
|
|
|
|
// NumberStaticResources: Number of static (i.e. cacheable) resources on
|
|
// the page.
|
|
NumberStaticResources int64 `json:"numberStaticResources,omitempty"`
|
|
|
|
// OtherResponseBytes: Number of response bytes for other resources on
|
|
// the page.
|
|
OtherResponseBytes int64 `json:"otherResponseBytes,omitempty,string"`
|
|
|
|
// TextResponseBytes: Number of uncompressed response bytes for text
|
|
// resources not covered by other statistics (i.e non-HTML, non-script,
|
|
// non-CSS resources) on the page.
|
|
TextResponseBytes int64 `json:"textResponseBytes,omitempty,string"`
|
|
|
|
// TotalRequestBytes: Total size of all request bytes sent by the page.
|
|
TotalRequestBytes int64 `json:"totalRequestBytes,omitempty,string"`
|
|
}
|
|
|
|
type ResultScreenshot struct {
|
|
// Data: Image data base64 encoded.
|
|
Data string `json:"data,omitempty"`
|
|
|
|
// Height: Height of screenshot in pixels.
|
|
Height int64 `json:"height,omitempty"`
|
|
|
|
// Mime_type: Mime type of image data. E.g. "image/jpeg".
|
|
Mime_type string `json:"mime_type,omitempty"`
|
|
|
|
// Width: Width of screenshot in pixels.
|
|
Width int64 `json:"width,omitempty"`
|
|
}
|
|
|
|
type ResultVersion struct {
|
|
// Major: The major version number of the Page Speed SDK used to
|
|
// generate these results.
|
|
Major int64 `json:"major,omitempty"`
|
|
|
|
// Minor: The minor version number of the Page Speed SDK used to
|
|
// generate these results.
|
|
Minor int64 `json:"minor,omitempty"`
|
|
}
|
|
|
|
// method id "pagespeedonline.pagespeedapi.runpagespeed":
|
|
|
|
type PagespeedapiRunpagespeedCall struct {
|
|
s *Service
|
|
url string
|
|
opt_ map[string]interface{}
|
|
}
|
|
|
|
// Runpagespeed: Runs Page Speed analysis on the page at the specified
|
|
// URL, and returns a Page Speed score, a list of suggestions to make
|
|
// that page faster, and other information.
|
|
func (r *PagespeedapiService) Runpagespeed(url string) *PagespeedapiRunpagespeedCall {
|
|
c := &PagespeedapiRunpagespeedCall{s: r.s, opt_: make(map[string]interface{})}
|
|
c.url = url
|
|
return c
|
|
}
|
|
|
|
// Filter_third_party_resources sets the optional parameter
|
|
// "filter_third_party_resources": Indicates if third party resources
|
|
// should be filtered out before PageSpeed analysis.
|
|
func (c *PagespeedapiRunpagespeedCall) Filter_third_party_resources(filter_third_party_resources bool) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["filter_third_party_resources"] = filter_third_party_resources
|
|
return c
|
|
}
|
|
|
|
// Locale sets the optional parameter "locale": The locale used to
|
|
// localize formatted results
|
|
func (c *PagespeedapiRunpagespeedCall) Locale(locale string) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["locale"] = locale
|
|
return c
|
|
}
|
|
|
|
// Rule sets the optional parameter "rule": A Page Speed rule to run; if
|
|
// none are given, all rules are run
|
|
func (c *PagespeedapiRunpagespeedCall) Rule(rule string) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["rule"] = rule
|
|
return c
|
|
}
|
|
|
|
// Screenshot sets the optional parameter "screenshot": Indicates if
|
|
// binary data containing a screenshot should be included
|
|
func (c *PagespeedapiRunpagespeedCall) Screenshot(screenshot bool) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["screenshot"] = screenshot
|
|
return c
|
|
}
|
|
|
|
// Strategy sets the optional parameter "strategy": The analysis
|
|
// strategy to use
|
|
func (c *PagespeedapiRunpagespeedCall) Strategy(strategy string) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["strategy"] = strategy
|
|
return c
|
|
}
|
|
|
|
// Fields allows partial responses to be retrieved.
|
|
// See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
|
|
// for more information.
|
|
func (c *PagespeedapiRunpagespeedCall) Fields(s ...googleapi.Field) *PagespeedapiRunpagespeedCall {
|
|
c.opt_["fields"] = googleapi.CombineFields(s)
|
|
return c
|
|
}
|
|
|
|
func (c *PagespeedapiRunpagespeedCall) Do() (*Result, error) {
|
|
var body io.Reader = nil
|
|
params := make(url.Values)
|
|
params.Set("alt", "json")
|
|
params.Set("url", fmt.Sprintf("%v", c.url))
|
|
if v, ok := c.opt_["filter_third_party_resources"]; ok {
|
|
params.Set("filter_third_party_resources", fmt.Sprintf("%v", v))
|
|
}
|
|
if v, ok := c.opt_["locale"]; ok {
|
|
params.Set("locale", fmt.Sprintf("%v", v))
|
|
}
|
|
if v, ok := c.opt_["rule"]; ok {
|
|
params.Set("rule", fmt.Sprintf("%v", v))
|
|
}
|
|
if v, ok := c.opt_["screenshot"]; ok {
|
|
params.Set("screenshot", fmt.Sprintf("%v", v))
|
|
}
|
|
if v, ok := c.opt_["strategy"]; ok {
|
|
params.Set("strategy", fmt.Sprintf("%v", v))
|
|
}
|
|
if v, ok := c.opt_["fields"]; ok {
|
|
params.Set("fields", fmt.Sprintf("%v", v))
|
|
}
|
|
urls := googleapi.ResolveRelative(c.s.BasePath, "runPagespeed")
|
|
urls += "?" + params.Encode()
|
|
req, _ := http.NewRequest("GET", urls, body)
|
|
googleapi.SetOpaque(req.URL)
|
|
req.Header.Set("User-Agent", "google-api-go-client/0.5")
|
|
res, err := c.s.client.Do(req)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer googleapi.CloseBody(res)
|
|
if err := googleapi.CheckResponse(res); err != nil {
|
|
return nil, err
|
|
}
|
|
var ret *Result
|
|
if err := json.NewDecoder(res.Body).Decode(&ret); err != nil {
|
|
return nil, err
|
|
}
|
|
return ret, nil
|
|
// {
|
|
// "description": "Runs Page Speed analysis on the page at the specified URL, and returns a Page Speed score, a list of suggestions to make that page faster, and other information.",
|
|
// "httpMethod": "GET",
|
|
// "id": "pagespeedonline.pagespeedapi.runpagespeed",
|
|
// "parameterOrder": [
|
|
// "url"
|
|
// ],
|
|
// "parameters": {
|
|
// "filter_third_party_resources": {
|
|
// "default": "false",
|
|
// "description": "Indicates if third party resources should be filtered out before PageSpeed analysis.",
|
|
// "location": "query",
|
|
// "type": "boolean"
|
|
// },
|
|
// "locale": {
|
|
// "description": "The locale used to localize formatted results",
|
|
// "location": "query",
|
|
// "pattern": "[a-zA-Z]+(_[a-zA-Z]+)?",
|
|
// "type": "string"
|
|
// },
|
|
// "rule": {
|
|
// "description": "A Page Speed rule to run; if none are given, all rules are run",
|
|
// "location": "query",
|
|
// "pattern": "[a-zA-Z]+",
|
|
// "repeated": true,
|
|
// "type": "string"
|
|
// },
|
|
// "screenshot": {
|
|
// "default": "false",
|
|
// "description": "Indicates if binary data containing a screenshot should be included",
|
|
// "location": "query",
|
|
// "type": "boolean"
|
|
// },
|
|
// "strategy": {
|
|
// "description": "The analysis strategy to use",
|
|
// "enum": [
|
|
// "desktop",
|
|
// "mobile"
|
|
// ],
|
|
// "enumDescriptions": [
|
|
// "Fetch and analyze the URL for desktop browsers",
|
|
// "Fetch and analyze the URL for mobile devices"
|
|
// ],
|
|
// "location": "query",
|
|
// "type": "string"
|
|
// },
|
|
// "url": {
|
|
// "description": "The URL to fetch and analyze",
|
|
// "location": "query",
|
|
// "pattern": "http(s)?://.*",
|
|
// "required": true,
|
|
// "type": "string"
|
|
// }
|
|
// },
|
|
// "path": "runPagespeed",
|
|
// "response": {
|
|
// "$ref": "Result"
|
|
// }
|
|
// }
|
|
|
|
}
|