|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319 |
- {
- "auth": {
- "oauth2": {
- "scopes": {
- "https://www.googleapis.com/auth/urlshortener": {
- "description": "Manage your goo.gl short URLs"
- }
- }
- }
- },
- "basePath": "/urlshortener/v1/",
- "baseUrl": "https://www.googleapis.com/urlshortener/v1/",
- "batchPath": "batch/urlshortener/v1",
- "description": "Lets you create, inspect, and manage goo.gl short URLs",
- "discoveryVersion": "v1",
- "documentationLink": "https://developers.google.com/url-shortener/v1/getting_started",
- "etag": "\"Zkyw9ACJZUvcYmlFaKGChzhmtnE/jbVoxNHEXKU6P25SSgxX2Q4e0lo\"",
- "icons": {
- "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
- "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
- },
- "id": "urlshortener:v1",
- "kind": "discovery#restDescription",
- "name": "urlshortener",
- "ownerDomain": "google.com",
- "ownerName": "Google",
- "parameters": {
- "alt": {
- "default": "json",
- "description": "Data format for the response.",
- "enum": [
- "json"
- ],
- "enumDescriptions": [
- "Responses with Content-Type of application/json"
- ],
- "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": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
- "location": "query",
- "type": "string"
- },
- "userIp": {
- "description": "Deprecated. Please use quotaUser instead.",
- "location": "query",
- "type": "string"
- }
- },
- "protocol": "rest",
- "resources": {
- "url": {
- "methods": {
- "get": {
- "description": "Expands a short URL or gets creation time and analytics.",
- "httpMethod": "GET",
- "id": "urlshortener.url.get",
- "parameterOrder": [
- "shortUrl"
- ],
- "parameters": {
- "projection": {
- "description": "Additional information to return.",
- "enum": [
- "ANALYTICS_CLICKS",
- "ANALYTICS_TOP_STRINGS",
- "FULL"
- ],
- "enumDescriptions": [
- "Returns only click counts.",
- "Returns only top string counts.",
- "Returns the creation timestamp and all available analytics."
- ],
- "location": "query",
- "type": "string"
- },
- "shortUrl": {
- "description": "The short URL, including the protocol.",
- "location": "query",
- "required": true,
- "type": "string"
- }
- },
- "path": "url",
- "response": {
- "$ref": "Url"
- },
- "scopes": [
- "https://www.googleapis.com/auth/urlshortener"
- ]
- },
- "insert": {
- "description": "Creates a new short URL.",
- "httpMethod": "POST",
- "id": "urlshortener.url.insert",
- "path": "url",
- "request": {
- "$ref": "Url"
- },
- "response": {
- "$ref": "Url"
- },
- "scopes": [
- "https://www.googleapis.com/auth/urlshortener"
- ]
- },
- "list": {
- "description": "Retrieves a list of URLs shortened by a user.",
- "httpMethod": "GET",
- "id": "urlshortener.url.list",
- "parameters": {
- "projection": {
- "description": "Additional information to return.",
- "enum": [
- "ANALYTICS_CLICKS",
- "FULL"
- ],
- "enumDescriptions": [
- "Returns short URL click counts.",
- "Returns short URL click counts."
- ],
- "location": "query",
- "type": "string"
- },
- "start-token": {
- "description": "Token for requesting successive pages of results.",
- "location": "query",
- "type": "string"
- }
- },
- "path": "url/history",
- "response": {
- "$ref": "UrlHistory"
- },
- "scopes": [
- "https://www.googleapis.com/auth/urlshortener"
- ]
- }
- }
- }
- },
- "revision": "20150519",
- "rootUrl": "https://www.googleapis.com/",
- "schemas": {
- "AnalyticsSnapshot": {
- "id": "AnalyticsSnapshot",
- "properties": {
- "browsers": {
- "description": "Top browsers, e.g. \"Chrome\"; sorted by (descending) click counts. Only present if this data is available.",
- "items": {
- "$ref": "StringCount"
- },
- "type": "array"
- },
- "countries": {
- "description": "Top countries (expressed as country codes), e.g. \"US\" or \"DE\"; sorted by (descending) click counts. Only present if this data is available.",
- "items": {
- "$ref": "StringCount"
- },
- "type": "array"
- },
- "longUrlClicks": {
- "description": "Number of clicks on all goo.gl short URLs pointing to this long URL.",
- "format": "int64",
- "type": "string"
- },
- "platforms": {
- "description": "Top platforms or OSes, e.g. \"Windows\"; sorted by (descending) click counts. Only present if this data is available.",
- "items": {
- "$ref": "StringCount"
- },
- "type": "array"
- },
- "referrers": {
- "description": "Top referring hosts, e.g. \"www.google.com\"; sorted by (descending) click counts. Only present if this data is available.",
- "items": {
- "$ref": "StringCount"
- },
- "type": "array"
- },
- "shortUrlClicks": {
- "description": "Number of clicks on this short URL.",
- "format": "int64",
- "type": "string"
- }
- },
- "type": "object"
- },
- "AnalyticsSummary": {
- "id": "AnalyticsSummary",
- "properties": {
- "allTime": {
- "$ref": "AnalyticsSnapshot",
- "description": "Click analytics over all time."
- },
- "day": {
- "$ref": "AnalyticsSnapshot",
- "description": "Click analytics over the last day."
- },
- "month": {
- "$ref": "AnalyticsSnapshot",
- "description": "Click analytics over the last month."
- },
- "twoHours": {
- "$ref": "AnalyticsSnapshot",
- "description": "Click analytics over the last two hours."
- },
- "week": {
- "$ref": "AnalyticsSnapshot",
- "description": "Click analytics over the last week."
- }
- },
- "type": "object"
- },
- "StringCount": {
- "id": "StringCount",
- "properties": {
- "count": {
- "description": "Number of clicks for this top entry, e.g. for this particular country or browser.",
- "format": "int64",
- "type": "string"
- },
- "id": {
- "description": "Label assigned to this top entry, e.g. \"US\" or \"Chrome\".",
- "type": "string"
- }
- },
- "type": "object"
- },
- "Url": {
- "id": "Url",
- "properties": {
- "analytics": {
- "$ref": "AnalyticsSummary",
- "description": "A summary of the click analytics for the short and long URL. Might not be present if not requested or currently unavailable."
- },
- "created": {
- "description": "Time the short URL was created; ISO 8601 representation using the yyyy-MM-dd'T'HH:mm:ss.SSSZZ format, e.g. \"2010-10-14T19:01:24.944+00:00\".",
- "type": "string"
- },
- "id": {
- "description": "Short URL, e.g. \"http://goo.gl/l6MS\".",
- "type": "string"
- },
- "kind": {
- "default": "urlshortener#url",
- "description": "The fixed string \"urlshortener#url\".",
- "type": "string"
- },
- "longUrl": {
- "description": "Long URL, e.g. \"http://www.google.com/\". Might not be present if the status is \"REMOVED\".",
- "type": "string"
- },
- "status": {
- "description": "Status of the target URL. Possible values: \"OK\", \"MALWARE\", \"PHISHING\", or \"REMOVED\". A URL might be marked \"REMOVED\" if it was flagged as spam, for example.",
- "type": "string"
- }
- },
- "type": "object"
- },
- "UrlHistory": {
- "id": "UrlHistory",
- "properties": {
- "items": {
- "description": "A list of URL resources.",
- "items": {
- "$ref": "Url"
- },
- "type": "array"
- },
- "itemsPerPage": {
- "description": "Number of items returned with each full \"page\" of results. Note that the last page could have fewer items than the \"itemsPerPage\" value.",
- "format": "int32",
- "type": "integer"
- },
- "kind": {
- "default": "urlshortener#urlHistory",
- "description": "The fixed string \"urlshortener#urlHistory\".",
- "type": "string"
- },
- "nextPageToken": {
- "description": "A token to provide to get the next page of results.",
- "type": "string"
- },
- "totalItems": {
- "description": "Total number of short URLs associated with this user (may be approximate).",
- "format": "int32",
- "type": "integer"
- }
- },
- "type": "object"
- }
- },
- "servicePath": "urlshortener/v1/",
- "title": "URL Shortener API",
- "version": "v1"
- }
|