{ "resources": { "sitemaps": { "methods": { "delete": { "parameters": { "feedpath": { "location": "path", "required": true, "description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.", "type": "string" }, "siteUrl": { "type": "string", "description": "The site's URL, including protocol. For example: `http://www.example.com/`.", "required": true, "location": "path" } }, "description": "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.", "scopes": [ "https://www.googleapis.com/auth/webmasters" ], "id": "webmasters.sitemaps.delete", "flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}", "httpMethod": "DELETE", "parameterOrder": [ "siteUrl", "feedpath" ], "path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}" }, "get": { "path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}", "httpMethod": "GET", "parameterOrder": [ "siteUrl", "feedpath" ], "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ], "parameters": { "siteUrl": { "description": "The site's URL, including protocol. For example: `http://www.example.com/`.", "type": "string", "location": "path", "required": true }, "feedpath": { "description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.", "type": "string", "location": "path", "required": true } }, "description": "Retrieves information about a specific sitemap.", "flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}", "id": "webmasters.sitemaps.get", "response": { "$ref": "WmxSitemap" } }, "list": { "httpMethod": "GET", "parameterOrder": [ "siteUrl" ], "path": "webmasters/v3/sites/{siteUrl}/sitemaps", "parameters": { "sitemapIndex": { "type": "string", "description": " A URL of a site's sitemap index. For example: `http://www.example.com/sitemapindex.xml`.", "location": "query" }, "siteUrl": { "location": "path", "required": true, "description": "The site's URL, including protocol. For example: `http://www.example.com/`.", "type": "string" } }, "description": " 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).", "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ], "id": "webmasters.sitemaps.list", "flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps", "response": { "$ref": "SitemapsListResponse" } }, "submit": { "flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}", "id": "webmasters.sitemaps.submit", "path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}", "httpMethod": "PUT", "parameterOrder": [ "siteUrl", "feedpath" ], "scopes": [ "https://www.googleapis.com/auth/webmasters" ], "parameters": { "siteUrl": { "type": "string", "description": "The site's URL, including protocol. For example: `http://www.example.com/`.", "required": true, "location": "path" }, "feedpath": { "description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.", "type": "string", "location": "path", "required": true } }, "description": "Submits a sitemap for a site." } } }, "searchanalytics": { "methods": { "query": { "request": { "$ref": "SearchAnalyticsQueryRequest" }, "flatPath": "webmasters/v3/sites/{siteUrl}/searchAnalytics/query", "id": "webmasters.searchanalytics.query", "response": { "$ref": "SearchAnalyticsQueryResponse" }, "path": "webmasters/v3/sites/{siteUrl}/searchAnalytics/query", "httpMethod": "POST", "parameterOrder": [ "siteUrl" ], "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ], "parameters": { "siteUrl": { "required": true, "location": "path", "type": "string", "description": "The site's URL, including protocol. For example: `http://www.example.com/`." } }, "description": "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." } } }, "sites": { "methods": { "delete": { "parameters": { "siteUrl": { "type": "string", "description": "The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.", "required": true, "location": "path" } }, "description": " Removes a site from the set of the user's Search Console sites.", "scopes": [ "https://www.googleapis.com/auth/webmasters" ], "id": "webmasters.sites.delete", "flatPath": "webmasters/v3/sites/{siteUrl}", "httpMethod": "DELETE", "parameterOrder": [ "siteUrl" ], "path": "webmasters/v3/sites/{siteUrl}" }, "get": { "response": { "$ref": "WmxSite" }, "flatPath": "webmasters/v3/sites/{siteUrl}", "id": "webmasters.sites.get", "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ], "parameters": { "siteUrl": { "type": "string", "description": "The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.", "required": true, "location": "path" } }, "description": " Retrieves information about specific site.", "path": "webmasters/v3/sites/{siteUrl}", "httpMethod": "GET", "parameterOrder": [ "siteUrl" ] }, "list": { "id": "webmasters.sites.list", "flatPath": "webmasters/v3/sites", "response": { "$ref": "SitesListResponse" }, "httpMethod": "GET", "parameterOrder": [], "path": "webmasters/v3/sites", "parameters": {}, "description": " Lists the user's Search Console sites.", "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ] }, "add": { "scopes": [ "https://www.googleapis.com/auth/webmasters" ], "parameters": { "siteUrl": { "description": "The URL of the site to add.", "type": "string", "location": "path", "required": true } }, "description": " Adds a site to the set of the user's sites in Search Console.", "flatPath": "webmasters/v3/sites/{siteUrl}", "id": "webmasters.sites.add", "path": "webmasters/v3/sites/{siteUrl}", "httpMethod": "PUT", "parameterOrder": [ "siteUrl" ] } } }, "urlInspection": { "resources": { "index": { "methods": { "inspect": { "response": { "$ref": "InspectUrlIndexResponse" }, "flatPath": "v1/urlInspection/index:inspect", "id": "searchconsole.urlInspection.index.inspect", "request": { "$ref": "InspectUrlIndexRequest" }, "scopes": [ "https://www.googleapis.com/auth/webmasters", "https://www.googleapis.com/auth/webmasters.readonly" ], "parameters": {}, "description": "Index inspection.", "path": "v1/urlInspection/index:inspect", "httpMethod": "POST", "parameterOrder": [] } } } } }, "urlTestingTools": { "resources": { "mobileFriendlyTest": { "methods": { "run": { "request": { "$ref": "RunMobileFriendlyTestRequest" }, "flatPath": "v1/urlTestingTools/mobileFriendlyTest:run", "id": "searchconsole.urlTestingTools.mobileFriendlyTest.run", "response": { "$ref": "RunMobileFriendlyTestResponse" }, "path": "v1/urlTestingTools/mobileFriendlyTest:run", "httpMethod": "POST", "parameterOrder": [], "parameters": {}, "description": "Runs Mobile-Friendly Test for a given URL." } } } } } }, "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "$.xgafv": { "type": "string", "enum": [ "1", "2" ], "description": "V1 error format.", "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ] }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "callback": { "description": "JSONP", "type": "string", "location": "query" }, "quotaUser": { "location": "query", "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters." }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "type": "string", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "uploadType": { "location": "query", "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" }, "alt": { "type": "string", "enum": [ "json", "media", "proto" ], "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "default": "json", "location": "query" } }, "discoveryVersion": "v1", "ownerName": "Google", "ownerDomain": "google.com", "title": "Google Search Console API", "mtlsRootUrl": "https://searchconsole.mtls.googleapis.com/", "baseUrl": "https://searchconsole.googleapis.com/", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "basePath": "", "canonicalName": "Search Console", "documentationLink": "https://developers.google.com/webmaster-tools/about", "protocol": "rest", "version_module": true, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/webmasters.readonly": { "description": "View Search Console data for your verified sites" }, "https://www.googleapis.com/auth/webmasters": { "description": "View and manage Search Console data for your verified sites" } } } }, "rootUrl": "https://searchconsole.googleapis.com/", "schemas": { "RunMobileFriendlyTestRequest": { "properties": { "url": { "description": "URL for inspection.", "type": "string" }, "requestScreenshot": { "description": "Whether or not screenshot is requested. Default is false.", "type": "boolean" } }, "type": "object", "id": "RunMobileFriendlyTestRequest", "description": "Mobile-friendly test request." }, "WmxSite": { "properties": { "permissionLevel": { "description": "The user's permission level for the site.", "type": "string", "enumDescriptions": [ "", "Owner has complete access to the site.", "Full users can access all data, and perform most of the operations.", "Restricted users can access most of the data, and perform some operations.", "Unverified user has no access to site's data." ], "enum": [ "SITE_PERMISSION_LEVEL_UNSPECIFIED", "SITE_OWNER", "SITE_FULL_USER", "SITE_RESTRICTED_USER", "SITE_UNVERIFIED_USER" ] }, "siteUrl": { "description": "The URL of the site.", "type": "string" } }, "id": "WmxSite", "description": "Contains permission level information about a Search Console site. For more information, see [Permissions in Search Console](https://support.google.com/webmasters/answer/2451999).", "type": "object" }, "ApiDataRow": { "type": "object", "id": "ApiDataRow", "properties": { "impressions": { "type": "number", "format": "double" }, "keys": { "type": "array", "items": { "type": "string" } }, "clicks": { "type": "number", "format": "double" }, "position": { "type": "number", "format": "double" }, "ctr": { "type": "number", "format": "double" } } }, "WmxSitemapContent": { "id": "WmxSitemapContent", "description": "Information about the various content types in the sitemap.", "type": "object", "properties": { "type": { "description": "The specific type of content in this sitemap. For example: `web`.", "type": "string", "enum": [ "WEB", "IMAGE", "VIDEO", "NEWS", "MOBILE", "ANDROID_APP", "PATTERN", "IOS_APP", "DATA_FEED_ELEMENT" ], "enumDeprecated": [ false, false, false, false, false, false, true, false, true ], "enumDescriptions": [ "", "", "", "", "", "", "Unsupported content type.", "", "Unsupported content type." ] }, "indexed": { "description": "*Deprecated; do not use.*", "type": "string", "deprecated": true, "format": "int64" }, "submitted": { "type": "string", "description": "The number of URLs in the sitemap (of the content type).", "format": "int64" } } }, "TestStatus": { "properties": { "status": { "type": "string", "enumDescriptions": [ "Internal error when running this test. Please try running the test again.", "Inspection has completed without errors.", "Inspection terminated in an error state. This indicates a problem in Google's infrastructure, not a user error. Please try again later.", "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." ], "enum": [ "TEST_STATUS_UNSPECIFIED", "COMPLETE", "INTERNAL_ERROR", "PAGE_UNREACHABLE" ], "description": "Status of the test." }, "details": { "type": "string", "description": "Error details if applicable." } }, "id": "TestStatus", "description": "Final state of the test, including error details if necessary.", "type": "object" }, "MobileUsabilityIssue": { "type": "object", "id": "MobileUsabilityIssue", "description": "Mobile-usability issue.", "properties": { "issueType": { "type": "string", "enumDescriptions": [ "Unknown issue. Sorry, we don't have any description for the rule that was broken.", "Plugins incompatible with mobile devices are being used. [Learn more] (https://support.google.com/webmasters/answer/6352293#flash_usage#error-list).", "Viewport is not specified using the meta viewport tag. [Learn more] (https://support.google.com/webmasters/answer/6352293#viewport_not_configured#error-list).", "Viewport defined to a fixed width. [Learn more] (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport#error-list).", "Content not sized to viewport. [Learn more] (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport#error-list).", "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).", "Touch elements are too close to each other. [Learn more] (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close#error-list)." ], "enum": [ "MOBILE_USABILITY_ISSUE_TYPE_UNSPECIFIED", "USES_INCOMPATIBLE_PLUGINS", "CONFIGURE_VIEWPORT", "FIXED_WIDTH_VIEWPORT", "SIZE_CONTENT_TO_VIEWPORT", "USE_LEGIBLE_FONT_SIZES", "TAP_TARGETS_TOO_CLOSE" ], "description": "Mobile-usability issue type." }, "severity": { "description": "Not returned; reserved for future use.", "type": "string", "enumDescriptions": [ "Unknown severity.", "Warning.", "Error." ], "enum": [ "SEVERITY_UNSPECIFIED", "WARNING", "ERROR" ] }, "message": { "type": "string", "description": "Additional information regarding the issue." } } }, "ApiDimensionFilter": { "id": "ApiDimensionFilter", "description": "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.", "type": "object", "properties": { "expression": { "type": "string" }, "dimension": { "type": "string", "enumDescriptions": [ "", "", "", "", "" ], "enum": [ "QUERY", "PAGE", "COUNTRY", "DEVICE", "SEARCH_APPEARANCE" ] }, "operator": { "type": "string", "enumDescriptions": [ "", "", "", "", "", "" ], "enum": [ "EQUALS", "NOT_EQUALS", "CONTAINS", "NOT_CONTAINS", "INCLUDING_REGEX", "EXCLUDING_REGEX" ] } } }, "UrlInspectionResult": { "properties": { "inspectionResultLink": { "description": "Link to Search Console URL inspection.", "type": "string" }, "mobileUsabilityResult": { "$ref": "MobileUsabilityInspectionResult", "deprecated": true, "description": "Result of the Mobile usability analysis." }, "indexStatusResult": { "$ref": "IndexStatusInspectionResult", "description": "Result of the index status analysis." }, "ampResult": { "$ref": "AmpInspectionResult", "description": "Result of the AMP analysis. Absent if the page is not an AMP page." }, "richResultsResult": { "description": "Result of the Rich Results analysis. Absent if there are no rich results found.", "$ref": "RichResultsInspectionResult" } }, "id": "UrlInspectionResult", "description": "URL inspection result, including all inspection results.", "type": "object" }, "RichResultsIssue": { "type": "object", "id": "RichResultsIssue", "description": "Severity and status of a single issue affecting a single rich result instance on a page.", "properties": { "issueMessage": { "type": "string", "description": "Rich Results issue type." }, "severity": { "type": "string", "enumDescriptions": [ "Unknown severity.", "Warning.", "Error." ], "enum": [ "SEVERITY_UNSPECIFIED", "WARNING", "ERROR" ], "description": "Severity of this issue: WARNING, or ERROR. Items with an issue of status ERROR cannot appear with rich result features in Google Search results." } } }, "SearchAnalyticsQueryResponse": { "properties": { "rows": { "description": "A list of rows grouped by the key values in the order given in the query.", "type": "array", "items": { "$ref": "ApiDataRow" } }, "responseAggregationType": { "description": "How the results were aggregated.", "type": "string", "enumDescriptions": [ "", "", "", "" ], "enum": [ "AUTO", "BY_PROPERTY", "BY_PAGE", "BY_NEWS_SHOWCASE_PANEL" ] }, "metadata": { "description": "An object that may be returned with your query results, providing context about the state of the data. See details in Metadata object documentation.", "$ref": "Metadata" } }, "type": "object", "id": "SearchAnalyticsQueryResponse", "description": "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." }, "AmpInspectionResult": { "properties": { "issues": { "items": { "$ref": "AmpIssue" }, "type": "array", "description": "A list of zero or more AMP issues found for the inspected URL." }, "ampUrl": { "type": "string", "description": "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." }, "robotsTxtState": { "type": "string", "enumDescriptions": [ "Unknown robots.txt state, typically because the page wasn't fetched or found, or because robots.txt itself couldn't be reached.", "Crawl allowed by robots.txt.", "Crawl blocked by robots.txt." ], "enum": [ "ROBOTS_TXT_STATE_UNSPECIFIED", "ALLOWED", "DISALLOWED" ], "description": "Whether or not the page is blocked to Google by a robots.txt rule." }, "indexingState": { "type": "string", "enumDescriptions": [ "Unknown indexing status.", "Indexing allowed.", "Indexing not allowed, 'noindex' detected.", "Indexing not allowed, 'unavailable_after' date expired." ], "enum": [ "AMP_INDEXING_STATE_UNSPECIFIED", "AMP_INDEXING_ALLOWED", "BLOCKED_DUE_TO_NOINDEX", "BLOCKED_DUE_TO_EXPIRED_UNAVAILABLE_AFTER" ], "description": "Whether or not the page blocks indexing through a noindex rule." }, "pageFetchState": { "type": "string", "enumDescriptions": [ "Unknown fetch state.", "Successful fetch.", "Soft 404.", "Blocked by robots.txt.", "Not found (404).", "Blocked due to unauthorized request (401).", "Server error (5xx).", "Redirection error.", "Blocked due to access forbidden (403).", "Blocked due to other 4xx issue (not 403, 404).", "Internal error.", "Invalid URL." ], "enum": [ "PAGE_FETCH_STATE_UNSPECIFIED", "SUCCESSFUL", "SOFT_404", "BLOCKED_ROBOTS_TXT", "NOT_FOUND", "ACCESS_DENIED", "SERVER_ERROR", "REDIRECT_ERROR", "ACCESS_FORBIDDEN", "BLOCKED_4XX", "INTERNAL_CRAWL_ERROR", "INVALID_URL" ], "description": "Whether or not Google could fetch the AMP." }, "verdict": { "type": "string", "enumDescriptions": [ "Unknown verdict.", "Equivalent to \"Valid\" for the page or item in Search Console.", "Reserved, no longer in use.", "Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.", "Equivalent to \"Excluded\" for the page or item in Search Console." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "PARTIAL", "FAIL", "NEUTRAL" ], "description": "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." }, "ampIndexStatusVerdict": { "description": "Index status of the AMP URL.", "type": "string", "enumDescriptions": [ "Unknown verdict.", "Equivalent to \"Valid\" for the page or item in Search Console.", "Reserved, no longer in use.", "Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.", "Equivalent to \"Excluded\" for the page or item in Search Console." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "PARTIAL", "FAIL", "NEUTRAL" ] }, "lastCrawlTime": { "format": "google-datetime", "description": "Last time this AMP version was crawled by Google. Absent if the URL was never crawled successfully.", "type": "string" } }, "type": "object", "id": "AmpInspectionResult", "description": "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." }, "RunMobileFriendlyTestResponse": { "properties": { "screenshot": { "description": "Screenshot of the requested URL.", "$ref": "Image" }, "testStatus": { "description": "Final state of the test, can be either complete or an error.", "$ref": "TestStatus" }, "mobileFriendlyIssues": { "description": "List of mobile-usability issues.", "type": "array", "items": { "$ref": "MobileFriendlyIssue" } }, "mobileFriendliness": { "description": "Test verdict, whether the page is mobile friendly or not.", "type": "string", "enumDescriptions": [ "Internal error when running this test. Please try running the test again.", "The page is mobile friendly.", "The page is not mobile friendly." ], "enum": [ "MOBILE_FRIENDLY_TEST_RESULT_UNSPECIFIED", "MOBILE_FRIENDLY", "NOT_MOBILE_FRIENDLY" ] }, "resourceIssues": { "type": "array", "description": "Information about embedded resources issues.", "items": { "$ref": "ResourceIssue" } } }, "id": "RunMobileFriendlyTestResponse", "description": "Mobile-friendly test response, including mobile-friendly issues and resource issues.", "type": "object" }, "DetectedItems": { "properties": { "richResultType": { "type": "string", "description": "Rich Results type" }, "items": { "type": "array", "description": "List of Rich Results items.", "items": { "$ref": "Item" } } }, "id": "DetectedItems", "description": "Rich Results items grouped by type.", "type": "object" }, "ApiDimensionFilterGroup": { "id": "ApiDimensionFilterGroup", "description": "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.", "type": "object", "properties": { "groupType": { "type": "string", "enumDescriptions": [ "" ], "enum": [ "AND" ] }, "filters": { "type": "array", "items": { "$ref": "ApiDimensionFilter" } } } }, "IndexStatusInspectionResult": { "properties": { "lastCrawlTime": { "description": "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.", "type": "string", "format": "google-datetime" }, "sitemap": { "description": "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.", "type": "array", "items": { "type": "string" } }, "verdict": { "type": "string", "enumDescriptions": [ "Unknown verdict.", "Equivalent to \"Valid\" for the page or item in Search Console.", "Reserved, no longer in use.", "Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.", "Equivalent to \"Excluded\" for the page or item in Search Console." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "PARTIAL", "FAIL", "NEUTRAL" ], "description": "High level verdict about whether the URL *is* indexed (indexed status), or *can be* indexed (live inspection)." }, "referringUrls": { "items": { "type": "string" }, "type": "array", "description": "URLs that link to the inspected URL, directly and indirectly." }, "robotsTxtState": { "description": "Whether or not the page is blocked to Google by a robots.txt rule.", "type": "string", "enumDescriptions": [ "Unknown robots.txt state, typically because the page wasn't fetched or found, or because robots.txt itself couldn't be reached.", "Crawl allowed by robots.txt.", "Crawl blocked by robots.txt." ], "enum": [ "ROBOTS_TXT_STATE_UNSPECIFIED", "ALLOWED", "DISALLOWED" ] }, "crawledAs": { "description": "Primary crawler that was used by Google to crawl your site.", "type": "string", "enumDescriptions": [ "Unknown user agent.", "Desktop user agent.", "Mobile user agent." ], "enum": [ "CRAWLING_USER_AGENT_UNSPECIFIED", "DESKTOP", "MOBILE" ] }, "userCanonical": { "type": "string", "description": "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." }, "googleCanonical": { "description": "The URL of the page that Google selected as canonical. If the page was not indexed, this field is absent.", "type": "string" }, "coverageState": { "type": "string", "description": "Could Google find and index the page. More details about page indexing appear in 'indexing_state'." }, "indexingState": { "type": "string", "enumDescriptions": [ "Unknown indexing status.", "Indexing allowed.", "Indexing not allowed, 'noindex' detected in 'robots' meta tag.", "Indexing not allowed, 'noindex' detected in 'X-Robots-Tag' http header.", "Reserved, no longer in use." ], "enum": [ "INDEXING_STATE_UNSPECIFIED", "INDEXING_ALLOWED", "BLOCKED_BY_META_TAG", "BLOCKED_BY_HTTP_HEADER", "BLOCKED_BY_ROBOTS_TXT" ], "description": "Whether or not the page blocks indexing through a noindex rule." }, "pageFetchState": { "type": "string", "enumDescriptions": [ "Unknown fetch state.", "Successful fetch.", "Soft 404.", "Blocked by robots.txt.", "Not found (404).", "Blocked due to unauthorized request (401).", "Server error (5xx).", "Redirection error.", "Blocked due to access forbidden (403).", "Blocked due to other 4xx issue (not 403, 404).", "Internal error.", "Invalid URL." ], "enum": [ "PAGE_FETCH_STATE_UNSPECIFIED", "SUCCESSFUL", "SOFT_404", "BLOCKED_ROBOTS_TXT", "NOT_FOUND", "ACCESS_DENIED", "SERVER_ERROR", "REDIRECT_ERROR", "ACCESS_FORBIDDEN", "BLOCKED_4XX", "INTERNAL_CRAWL_ERROR", "INVALID_URL" ], "description": "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." } }, "type": "object", "id": "IndexStatusInspectionResult", "description": "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)." }, "WmxSitemap": { "properties": { "isSitemapsIndex": { "description": "If true, the sitemap is a collection of sitemaps.", "type": "boolean" }, "warnings": { "format": "int64", "description": "Number of warnings for the sitemap. These are generally non-critical issues with URLs in the sitemaps.", "type": "string" }, "isPending": { "type": "boolean", "description": "If true, the sitemap has not been processed." }, "contents": { "description": "The various content types in the sitemap.", "type": "array", "items": { "$ref": "WmxSitemapContent" } }, "path": { "type": "string", "description": "The url of the sitemap." }, "lastDownloaded": { "type": "string", "description": "Date & time in which this sitemap was last downloaded. Date format is in RFC 3339 format (yyyy-mm-dd).", "format": "google-datetime" }, "lastSubmitted": { "format": "google-datetime", "type": "string", "description": "Date & time in which this sitemap was submitted. Date format is in RFC 3339 format (yyyy-mm-dd)." }, "type": { "enumDescriptions": [ "", "", "", "", "", "Unsupported sitemap types.", "" ], "enumDeprecated": [ false, false, false, false, false, true, true ], "type": "string", "enum": [ "NOT_SITEMAP", "URL_LIST", "SITEMAP", "RSS_FEED", "ATOM_FEED", "PATTERN_SITEMAP", "OCEANFRONT" ], "description": "The type of the sitemap. For example: `rssFeed`." }, "errors": { "format": "int64", "type": "string", "description": "Number of errors in the sitemap. These are issues with the sitemap itself that need to be fixed before it can be processed correctly." } }, "type": "object", "id": "WmxSitemap", "description": "Contains detailed information about a specific URL submitted as a [sitemap](https://support.google.com/webmasters/answer/156184)." }, "MobileFriendlyIssue": { "properties": { "rule": { "description": "Rule violated.", "type": "string", "enumDescriptions": [ "Unknown rule. Sorry, we don't have any description for the rule that was broken.", "Plugins incompatible with mobile devices are being used. [Learn more] (https://support.google.com/webmasters/answer/6352293#flash_usage).", "Viewport is not specified using the meta viewport tag. [Learn more] (https://support.google.com/webmasters/answer/6352293#viewport_not_configured).", "Viewport defined to a fixed width. [Learn more] (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport).", "Content not sized to viewport. [Learn more] (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport).", "Font size is too small for easy reading on a small screen. [Learn More] (https://support.google.com/webmasters/answer/6352293#small_font_size).", "Touch elements are too close to each other. [Learn more] (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close)." ], "enum": [ "MOBILE_FRIENDLY_RULE_UNSPECIFIED", "USES_INCOMPATIBLE_PLUGINS", "CONFIGURE_VIEWPORT", "FIXED_WIDTH_VIEWPORT", "SIZE_CONTENT_TO_VIEWPORT", "USE_LEGIBLE_FONT_SIZES", "TAP_TARGETS_TOO_CLOSE" ] } }, "id": "MobileFriendlyIssue", "description": "Mobile-friendly issue.", "type": "object" }, "Metadata": { "type": "object", "id": "Metadata", "description": "An object that may be returned with your query results, providing context about the state of the data. When you request recent data (using `all` or `hourly_all` for `dataState`), some of the rows returned may represent data that is incomplete, which means that the data is still being collected and processed. This metadata object helps you identify exactly when this starts and ends. All dates and times provided in this object are in the `America/Los_Angeles` time zone. The specific field returned within this object depends on how you've grouped your data in the request. See details in inner fields.", "properties": { "firstIncompleteDate": { "description": "The first date for which the data is still being collected and processed, presented in `YYYY-MM-DD` format (ISO-8601 extended local date format). This field is populated only when the request's `dataState` is \"`all`\", data is grouped by \"`DATE`\", and the requested date range contains incomplete data points. All values after the `first_incomplete_date` may still change noticeably.", "type": "string" }, "firstIncompleteHour": { "type": "string", "description": "The first hour for which the data is still being collected and processed, presented in `YYYY-MM-DDThh:mm:ss[+|-]hh:mm` format (ISO-8601 extended offset date-time format). This field is populated only when the request's `dataState` is \"`hourly_all`\", data is grouped by \"`HOUR`\" and the requested date range contains incomplete data points. All values after the `first_incomplete_hour` may still change noticeably." } } }, "Image": { "properties": { "data": { "format": "byte", "description": "Image data in format determined by the mime type. Currently, the format will always be \"image/png\", but this might change in the future.", "type": "string" }, "mimeType": { "description": "The mime-type of the image data.", "type": "string" } }, "type": "object", "id": "Image", "description": "Describe image data." }, "InspectUrlIndexRequest": { "type": "object", "id": "InspectUrlIndexRequest", "description": "Index inspection request.", "properties": { "siteUrl": { "description": "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.", "type": "string" }, "languageCode": { "type": "string", "description": "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\"." }, "inspectionUrl": { "type": "string", "description": "Required. URL to inspect. Must be under the property specified in \"site_url\"." } } }, "SitemapsListResponse": { "properties": { "sitemap": { "items": { "$ref": "WmxSitemap" }, "type": "array", "description": "Contains detailed information about a specific URL submitted as a [sitemap](https://support.google.com/webmasters/answer/156184)." } }, "id": "SitemapsListResponse", "description": "List of sitemaps.", "type": "object" }, "RichResultsInspectionResult": { "type": "object", "id": "RichResultsInspectionResult", "description": "Rich-Results inspection result, including any rich results found at this URL.", "properties": { "verdict": { "type": "string", "enumDescriptions": [ "Unknown verdict.", "Equivalent to \"Valid\" for the page or item in Search Console.", "Reserved, no longer in use.", "Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.", "Equivalent to \"Excluded\" for the page or item in Search Console." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "PARTIAL", "FAIL", "NEUTRAL" ], "description": "High-level rich results inspection result for this URL." }, "detectedItems": { "items": { "$ref": "DetectedItems" }, "description": "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.", "type": "array" } } }, "AmpIssue": { "type": "object", "id": "AmpIssue", "description": "AMP issue.", "properties": { "issueMessage": { "description": "Brief description of this issue.", "type": "string" }, "severity": { "type": "string", "enumDescriptions": [ "Unknown severity.", "Warning.", "Error." ], "enum": [ "SEVERITY_UNSPECIFIED", "WARNING", "ERROR" ], "description": "Severity of this issue: WARNING or ERROR." } } }, "SearchAnalyticsQueryRequest": { "id": "SearchAnalyticsQueryRequest", "type": "object", "properties": { "searchType": { "type": "string", "enumDescriptions": [ "", "", "", "News tab in search.", "Discover.", "Google News (news.google.com or mobile app)." ], "enum": [ "WEB", "IMAGE", "VIDEO", "NEWS", "DISCOVER", "GOOGLE_NEWS" ], "description": "[Optional; Default is \\\"web\\\"] The search type to filter for." }, "startDate": { "description": " [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.", "type": "string" }, "rowLimit": { "format": "int32", "type": "integer", "description": "[Optional; Default is 1000] The maximum number of rows to return. Must be a number from 1 to 25,000 (inclusive)." }, "dataState": { "type": "string", "enumDescriptions": [ "Default value, should not be used.", "Include full final data only, without partial.", "Include all data, full and partial.", "Include hourly data, full and partial. Required when grouping by HOUR." ], "enum": [ "DATA_STATE_UNSPECIFIED", "FINAL", "ALL", "HOURLY_ALL" ], "description": "The data state to be fetched, can be full or all, the latter including full and partial data." }, "dimensionFilterGroups": { "items": { "$ref": "ApiDimensionFilterGroup" }, "type": "array", "description": "[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." }, "aggregationType": { "type": "string", "enumDescriptions": [ "", "", "", "" ], "enum": [ "AUTO", "BY_PROPERTY", "BY_PAGE", "BY_NEWS_SHOWCASE_PANEL" ], "description": "[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." }, "startRow": { "type": "integer", "description": "[Optional; Default is 0] Zero-based index of the first row in the response. Must be a non-negative number.", "format": "int32" }, "dimensions": { "description": "[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.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Group by date, which is returned in YYYY-MM-DD format, in PT time (UTC - 7:00/8:00).", "Group by query string.", "Group by page, a URI string.", "Group by country, specified by 3-letter country code ([ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)).", "Group by device type (DESKTOP, MOBILE and TABLET).", "Group by search result feature.", "Group by hour, which is returned in YYYY-MM-DDThh:mm:ss[+|-]hh:mm format (ISO-8601 extended offset date-time format) in PT time (UTC - 7:00/8:00). Data is available up to 10 days. Requires setting the dataState to HOURLY_ALL." ], "enum": [ "DATE", "QUERY", "PAGE", "COUNTRY", "DEVICE", "SEARCH_APPEARANCE", "HOUR" ] } }, "type": { "type": "string", "enumDescriptions": [ "", "", "", "News tab in search.", "Discover.", "Google News (news.google.com or mobile app)." ], "enum": [ "WEB", "IMAGE", "VIDEO", "NEWS", "DISCOVER", "GOOGLE_NEWS" ], "description": "Optional. [Optional; Default is \\\"web\\\"] Type of report: search type, or either Discover or Gnews." }, "endDate": { "type": "string", "description": "[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." } } }, "ResourceIssue": { "properties": { "blockedResource": { "description": "Describes a blocked resource issue.", "$ref": "BlockedResource" } }, "id": "ResourceIssue", "description": "Information about a resource with issue.", "type": "object" }, "BlockedResource": { "properties": { "url": { "type": "string", "description": "URL of the blocked resource." } }, "id": "BlockedResource", "description": "Blocked resource.", "type": "object" }, "MobileUsabilityInspectionResult": { "properties": { "verdict": { "description": "High-level mobile-usability inspection result for this URL.", "type": "string", "enumDescriptions": [ "Unknown verdict.", "Equivalent to \"Valid\" for the page or item in Search Console.", "Reserved, no longer in use.", "Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.", "Equivalent to \"Excluded\" for the page or item in Search Console." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "PARTIAL", "FAIL", "NEUTRAL" ] }, "issues": { "items": { "$ref": "MobileUsabilityIssue" }, "type": "array", "description": "A list of zero or more mobile-usability issues detected for this URL." } }, "id": "MobileUsabilityInspectionResult", "description": "Mobile-usability inspection results.", "type": "object" }, "Item": { "id": "Item", "description": "A specific rich result found on the page.", "type": "object", "properties": { "name": { "description": "The user-provided name of this item.", "type": "string" }, "issues": { "items": { "$ref": "RichResultsIssue" }, "description": "A list of zero or more rich result issues found for this instance.", "type": "array" } } }, "InspectUrlIndexResponse": { "type": "object", "id": "InspectUrlIndexResponse", "description": "Index-Status inspection response.", "properties": { "inspectionResult": { "$ref": "UrlInspectionResult", "description": "URL inspection results." } } }, "SitesListResponse": { "properties": { "siteEntry": { "items": { "$ref": "WmxSite" }, "description": "Contains permission level information about a Search Console site. For more information, see [Permissions in Search Console](https://support.google.com/webmasters/answer/2451999).", "type": "array" } }, "type": "object", "id": "SitesListResponse", "description": "List of sites with access level information." } }, "version": "v1", "servicePath": "", "description": "The Search Console API provides access to both Search Console data (verified users only) and to public information on an URL basis (anyone)", "revision": "20260701", "name": "searchconsole", "batchPath": "batch", "kind": "discovery#restDescription", "id": "searchconsole:v1", "fullyEncodeReservedExpansion": true }