blob: 2f38856bf165570a585886990b4ea196c4af4649 [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/webmasters": {
"description": "View and manage Search Console data for your verified sites"
},
"https://www.googleapis.com/auth/webmasters.readonly": {
"description": "View Search Console data for your verified sites"
}
}
}
},
"basePath": "",
"baseUrl": "https://searchconsole.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Search Console",
"description": "The Search Console API provides access to both Search Console data (verified users only) and to public information on an URL basis (anyone)",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/webmaster-tools/search-console-api/",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "searchconsole:v1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://searchconsole.mtls.googleapis.com/",
"name": "searchconsole",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"type": "string"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"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.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"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.",
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"searchanalytics": {
"methods": {
"query": {
"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.",
"flatPath": "webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
"httpMethod": "POST",
"id": "webmasters.searchanalytics.query",
"parameterOrder": [
"siteUrl"
],
"parameters": {
"siteUrl": {
"description": "The site's URL, including protocol. For example: `http://www.example.com/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
"request": {
"$ref": "SearchAnalyticsQueryRequest"
},
"response": {
"$ref": "SearchAnalyticsQueryResponse"
},
"scopes": [
"https://www.googleapis.com/auth/webmasters",
"https://www.googleapis.com/auth/webmasters.readonly"
]
}
}
},
"sitemaps": {
"methods": {
"delete": {
"description": "Deletes a sitemap from this site.",
"flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"httpMethod": "DELETE",
"id": "webmasters.sitemaps.delete",
"parameterOrder": [
"siteUrl",
"feedpath"
],
"parameters": {
"feedpath": {
"description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.",
"location": "path",
"required": true,
"type": "string"
},
"siteUrl": {
"description": "The site's URL, including protocol. For example: `http://www.example.com/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"scopes": [
"https://www.googleapis.com/auth/webmasters"
]
},
"get": {
"description": "Retrieves information about a specific sitemap.",
"flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"httpMethod": "GET",
"id": "webmasters.sitemaps.get",
"parameterOrder": [
"siteUrl",
"feedpath"
],
"parameters": {
"feedpath": {
"description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.",
"location": "path",
"required": true,
"type": "string"
},
"siteUrl": {
"description": "The site's URL, including protocol. For example: `http://www.example.com/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"response": {
"$ref": "WmxSitemap"
},
"scopes": [
"https://www.googleapis.com/auth/webmasters",
"https://www.googleapis.com/auth/webmasters.readonly"
]
},
"list": {
"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).",
"flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps",
"httpMethod": "GET",
"id": "webmasters.sitemaps.list",
"parameterOrder": [
"siteUrl"
],
"parameters": {
"siteUrl": {
"description": "The site's URL, including protocol. For example: `http://www.example.com/`.",
"location": "path",
"required": true,
"type": "string"
},
"sitemapIndex": {
"description": " A URL of a site's sitemap index. For example: `http://www.example.com/sitemapindex.xml`.",
"location": "query",
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}/sitemaps",
"response": {
"$ref": "SitemapsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/webmasters",
"https://www.googleapis.com/auth/webmasters.readonly"
]
},
"submit": {
"description": "Submits a sitemap for a site.",
"flatPath": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"httpMethod": "PUT",
"id": "webmasters.sitemaps.submit",
"parameterOrder": [
"siteUrl",
"feedpath"
],
"parameters": {
"feedpath": {
"description": "The URL of the actual sitemap. For example: `http://www.example.com/sitemap.xml`.",
"location": "path",
"required": true,
"type": "string"
},
"siteUrl": {
"description": "The site's URL, including protocol. For example: `http://www.example.com/`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}",
"scopes": [
"https://www.googleapis.com/auth/webmasters"
]
}
}
},
"sites": {
"methods": {
"add": {
"description": " Adds a site to the set of the user's sites in Search Console.",
"flatPath": "webmasters/v3/sites/{siteUrl}",
"httpMethod": "PUT",
"id": "webmasters.sites.add",
"parameterOrder": [
"siteUrl"
],
"parameters": {
"siteUrl": {
"description": "The URL of the site to add.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}",
"scopes": [
"https://www.googleapis.com/auth/webmasters"
]
},
"delete": {
"description": " Removes a site from the set of the user's Search Console sites.",
"flatPath": "webmasters/v3/sites/{siteUrl}",
"httpMethod": "DELETE",
"id": "webmasters.sites.delete",
"parameterOrder": [
"siteUrl"
],
"parameters": {
"siteUrl": {
"description": "The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}",
"scopes": [
"https://www.googleapis.com/auth/webmasters"
]
},
"get": {
"description": " Retrieves information about specific site.",
"flatPath": "webmasters/v3/sites/{siteUrl}",
"httpMethod": "GET",
"id": "webmasters.sites.get",
"parameterOrder": [
"siteUrl"
],
"parameters": {
"siteUrl": {
"description": "The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "webmasters/v3/sites/{siteUrl}",
"response": {
"$ref": "WmxSite"
},
"scopes": [
"https://www.googleapis.com/auth/webmasters",
"https://www.googleapis.com/auth/webmasters.readonly"
]
},
"list": {
"description": " Lists the user's Search Console sites.",
"flatPath": "webmasters/v3/sites",
"httpMethod": "GET",
"id": "webmasters.sites.list",
"parameterOrder": [],
"parameters": {},
"path": "webmasters/v3/sites",
"response": {
"$ref": "SitesListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/webmasters",
"https://www.googleapis.com/auth/webmasters.readonly"
]
}
}
},
"urlTestingTools": {
"resources": {
"mobileFriendlyTest": {
"methods": {
"run": {
"description": "Runs Mobile-Friendly Test for a given URL.",
"flatPath": "v1/urlTestingTools/mobileFriendlyTest:run",
"httpMethod": "POST",
"id": "searchconsole.urlTestingTools.mobileFriendlyTest.run",
"parameterOrder": [],
"parameters": {},
"path": "v1/urlTestingTools/mobileFriendlyTest:run",
"request": {
"$ref": "RunMobileFriendlyTestRequest"
},
"response": {
"$ref": "RunMobileFriendlyTestResponse"
}
}
}
}
}
}
},
"revision": "20200919",
"rootUrl": "https://searchconsole.googleapis.com/",
"schemas": {
"ApiDataRow": {
"id": "ApiDataRow",
"properties": {
"clicks": {
"format": "double",
"type": "number"
},
"ctr": {
"format": "double",
"type": "number"
},
"impressions": {
"format": "double",
"type": "number"
},
"keys": {
"items": {
"type": "string"
},
"type": "array"
},
"position": {
"format": "double",
"type": "number"
}
},
"type": "object"
},
"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.",
"id": "ApiDimensionFilter",
"properties": {
"dimension": {
"enum": [
"QUERY",
"PAGE",
"COUNTRY",
"DEVICE",
"SEARCH_APPEARANCE"
],
"enumDescriptions": [
"",
"",
"",
"",
""
],
"type": "string"
},
"expression": {
"type": "string"
},
"operator": {
"enum": [
"EQUALS",
"NOT_EQUALS",
"CONTAINS",
"NOT_CONTAINS"
],
"enumDescriptions": [
"",
"",
"",
""
],
"type": "string"
}
},
"type": "object"
},
"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.",
"id": "ApiDimensionFilterGroup",
"properties": {
"filters": {
"items": {
"$ref": "ApiDimensionFilter"
},
"type": "array"
},
"groupType": {
"enum": [
"AND"
],
"enumDescriptions": [
""
],
"type": "string"
}
},
"type": "object"
},
"BlockedResource": {
"description": "Blocked resource.",
"id": "BlockedResource",
"properties": {
"url": {
"description": "URL of the blocked resource.",
"type": "string"
}
},
"type": "object"
},
"Image": {
"description": "Describe image data.",
"id": "Image",
"properties": {
"data": {
"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.",
"format": "byte",
"type": "string"
},
"mimeType": {
"description": "The mime-type of the image data.",
"type": "string"
}
},
"type": "object"
},
"MobileFriendlyIssue": {
"description": "Mobile-friendly issue.",
"id": "MobileFriendlyIssue",
"properties": {
"rule": {
"description": "Rule violated.",
"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"
],
"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).",
"Viewsport 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)."
],
"type": "string"
}
},
"type": "object"
},
"ResourceIssue": {
"description": "Information about a resource with issue.",
"id": "ResourceIssue",
"properties": {
"blockedResource": {
"$ref": "BlockedResource",
"description": "Describes a blocked resource issue."
}
},
"type": "object"
},
"RunMobileFriendlyTestRequest": {
"description": "Mobile-friendly test request.",
"id": "RunMobileFriendlyTestRequest",
"properties": {
"requestScreenshot": {
"description": "Whether or not screenshot is requested. Default is false.",
"type": "boolean"
},
"url": {
"description": "URL for inspection.",
"type": "string"
}
},
"type": "object"
},
"RunMobileFriendlyTestResponse": {
"description": "Mobile-friendly test response, including mobile-friendly issues and resource issues.",
"id": "RunMobileFriendlyTestResponse",
"properties": {
"mobileFriendliness": {
"description": "Test verdict, whether the page is mobile friendly or not.",
"enum": [
"MOBILE_FRIENDLY_TEST_RESULT_UNSPECIFIED",
"MOBILE_FRIENDLY",
"NOT_MOBILE_FRIENDLY"
],
"enumDescriptions": [
"Internal error when running this test. Please try running the test again.",
"The page is mobile friendly.",
"The page is not mobile friendly."
],
"type": "string"
},
"mobileFriendlyIssues": {
"description": "List of mobile-usability issues.",
"items": {
"$ref": "MobileFriendlyIssue"
},
"type": "array"
},
"resourceIssues": {
"description": "Information about embedded resources issues.",
"items": {
"$ref": "ResourceIssue"
},
"type": "array"
},
"screenshot": {
"$ref": "Image",
"description": "Screenshot of the requested URL."
},
"testStatus": {
"$ref": "TestStatus",
"description": "Final state of the test, can be either complete or an error."
}
},
"type": "object"
},
"SearchAnalyticsQueryRequest": {
"id": "SearchAnalyticsQueryRequest",
"properties": {
"aggregationType": {
"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.",
"enum": [
"AUTO",
"BY_PROPERTY",
"BY_PAGE"
],
"enumDescriptions": [
"",
"",
""
],
"type": "string"
},
"dimensionFilterGroups": {
"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.",
"items": {
"$ref": "ApiDimensionFilterGroup"
},
"type": "array"
},
"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.",
"items": {
"enum": [
"DATE",
"QUERY",
"PAGE",
"COUNTRY",
"DEVICE",
"SEARCH_APPEARANCE"
],
"enumDescriptions": [
"",
"",
"",
"",
"",
""
],
"type": "string"
},
"type": "array"
},
"endDate": {
"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.",
"type": "string"
},
"rowLimit": {
"description": "[Optional; Default is 1000] The maximum number of rows to return. Must be a number from 1 to 25,000 (inclusive).",
"format": "int32",
"type": "integer"
},
"searchType": {
"description": "[Optional; Default is \\\"web\\\"] The search type to filter for.",
"enum": [
"WEB",
"IMAGE",
"VIDEO"
],
"enumDescriptions": [
"",
"",
""
],
"type": "string"
},
"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"
},
"startRow": {
"description": "[Optional; Default is 0] Zero-based index of the first row in the response. Must be a non-negative number.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"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.",
"id": "SearchAnalyticsQueryResponse",
"properties": {
"responseAggregationType": {
"description": "How the results were aggregated.",
"enum": [
"AUTO",
"BY_PROPERTY",
"BY_PAGE"
],
"enumDescriptions": [
"",
"",
""
],
"type": "string"
},
"rows": {
"description": "A list of rows grouped by the key values in the order given in the query.",
"items": {
"$ref": "ApiDataRow"
},
"type": "array"
}
},
"type": "object"
},
"SitemapsListResponse": {
"description": "List of sitemaps.",
"id": "SitemapsListResponse",
"properties": {
"sitemap": {
"description": "Contains detailed information about a specific URL submitted as a [sitemap](https://support.google.com/webmasters/answer/156184).",
"items": {
"$ref": "WmxSitemap"
},
"type": "array"
}
},
"type": "object"
},
"SitesListResponse": {
"description": "List of sites with access level information.",
"id": "SitesListResponse",
"properties": {
"siteEntry": {
"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).",
"items": {
"$ref": "WmxSite"
},
"type": "array"
}
},
"type": "object"
},
"TestStatus": {
"description": "Final state of the test, including error details if necessary.",
"id": "TestStatus",
"properties": {
"details": {
"description": "Error details if applicable.",
"type": "string"
},
"status": {
"description": "Status of the test.",
"enum": [
"TEST_STATUS_UNSPECIFIED",
"COMPLETE",
"INTERNAL_ERROR",
"PAGE_UNREACHABLE"
],
"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."
],
"type": "string"
}
},
"type": "object"
},
"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).",
"id": "WmxSite",
"properties": {
"permissionLevel": {
"description": "The user's permission level for the site.",
"enum": [
"SITE_PERMISSION_LEVEL_UNSPECIFIED",
"SITE_OWNER",
"SITE_FULL_USER",
"SITE_RESTRICTED_USER",
"SITE_UNVERIFIED_USER"
],
"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."
],
"type": "string"
},
"siteUrl": {
"description": "The URL of the site.",
"type": "string"
}
},
"type": "object"
},
"WmxSitemap": {
"description": "Contains detailed information about a specific URL submitted as a [sitemap](https://support.google.com/webmasters/answer/156184).",
"id": "WmxSitemap",
"properties": {
"contents": {
"description": "The various content types in the sitemap.",
"items": {
"$ref": "WmxSitemapContent"
},
"type": "array"
},
"errors": {
"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.",
"format": "int64",
"type": "string"
},
"isPending": {
"description": "If true, the sitemap has not been processed.",
"type": "boolean"
},
"isSitemapsIndex": {
"description": "If true, the sitemap is a collection of sitemaps.",
"type": "boolean"
},
"lastDownloaded": {
"description": "Date \u0026 time in which this sitemap was last downloaded. Date format is in RFC 3339 format (yyyy-mm-dd).",
"format": "google-datetime",
"type": "string"
},
"lastSubmitted": {
"description": "Date \u0026 time in which this sitemap was submitted. Date format is in RFC 3339 format (yyyy-mm-dd).",
"format": "google-datetime",
"type": "string"
},
"path": {
"description": "The url of the sitemap.",
"type": "string"
},
"type": {
"description": "The type of the sitemap. For example: `rssFeed`.",
"enum": [
"NOT_SITEMAP",
"URL_LIST",
"SITEMAP",
"RSS_FEED",
"ATOM_FEED",
"PATTERN_SITEMAP",
"OCEANFRONT"
],
"enumDescriptions": [
"",
"",
"",
"",
"",
"Unsupported sitemap types.",
""
],
"type": "string"
},
"warnings": {
"description": "Number of warnings for the sitemap. These are generally non-critical issues with URLs in the sitemaps.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"WmxSitemapContent": {
"description": "Information about the various content types in the sitemap.",
"id": "WmxSitemapContent",
"properties": {
"indexed": {
"description": "The number of URLs from the sitemap that were indexed (of the content type).",
"format": "int64",
"type": "string"
},
"submitted": {
"description": "The number of URLs in the sitemap (of the content type).",
"format": "int64",
"type": "string"
},
"type": {
"description": "The specific type of content in this sitemap. For example: `web`.",
"enum": [
"WEB",
"IMAGE",
"VIDEO",
"NEWS",
"MOBILE",
"ANDROID_APP",
"PATTERN",
"IOS_APP",
"DATA_FEED_ELEMENT"
],
"enumDescriptions": [
"",
"",
"",
"",
"",
"",
"Unsupported content type.",
"",
"Unsupported content type."
],
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "",
"title": "Google Search Console API",
"version": "v1",
"version_module": true
}