restic/vendor/google.golang.org/api/blogger/v2/blogger-api.json

{
 "kind": "discovery#restDescription",
 "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/Mm4a0u3lPNBqEzKCYhfhIpC2Mw4\"",
 "discoveryVersion": "v1",
 "id": "blogger:v2",
 "name": "blogger",
 "version": "v2",
 "revision": "20150422",
 "title": "Blogger API",
 "description": "API for access to the data within Blogger.",
 "ownerDomain": "google.com",
 "ownerName": "Google",
 "icons": {
  "x16": "https://www.google.com/images/icons/product/blogger-16.png",
  "x32": "https://www.google.com/images/icons/product/blogger-32.png"
 },
 "documentationLink": "https://developers.google.com/blogger/docs/2.0/json/getting_started",
 "labels": [
  "limited_availability"
 ],
 "protocol": "rest",
 "baseUrl": "https://www.googleapis.com/blogger/v2/",
 "basePath": "/blogger/v2/",
 "rootUrl": "https://www.googleapis.com/",
 "servicePath": "blogger/v2/",
 "batchPath": "batch",
 "parameters": {
  "alt": {
   "type": "string",
   "description": "Data format for the response.",
   "default": "json",
   "enum": [
    "json"
   ],
   "enumDescriptions": [
    "Responses with Content-Type of application/json"
   ],
   "location": "query"
  },
  "fields": {
   "type": "string",
   "description": "Selector specifying which fields to include in a partial response.",
   "location": "query"
  },
  "key": {
   "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.",
   "location": "query"
  },
  "oauth_token": {
   "type": "string",
   "description": "OAuth 2.0 token for the current user.",
   "location": "query"
  },
  "prettyPrint": {
   "type": "boolean",
   "description": "Returns response with indentations and line breaks.",
   "default": "true",
   "location": "query"
  },
  "quotaUser": {
   "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. Overrides userIp if both are provided.",
   "location": "query"
  },
  "userIp": {
   "type": "string",
   "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
   "location": "query"
  }
 },
 "auth": {
  "oauth2": {
   "scopes": {
    "https://www.googleapis.com/auth/blogger": {
     "description": "Manage your Blogger account"
    }
   }
  }
 },
 "schemas": {
  "Blog": {
   "id": "Blog",
   "type": "object",
   "properties": {
    "description": {
     "type": "string",
     "description": "The description of this blog. This is displayed underneath the title."
    },
    "id": {
     "type": "string",
     "description": "The identifier for this resource.",
     "format": "int64"
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entry. Always blogger#blog",
     "default": "blogger#blog"
    },
    "locale": {
     "type": "object",
     "description": "The locale this Blog is set to.",
     "properties": {
      "country": {
       "type": "string",
       "description": "The country this blog's locale is set to."
      },
      "language": {
       "type": "string",
       "description": "The language this blog is authored in."
      },
      "variant": {
       "type": "string",
       "description": "The language variant this blog is authored in."
      }
     }
    },
    "name": {
     "type": "string",
     "description": "The name of this blog. This is displayed as the title."
    },
    "pages": {
     "type": "object",
     "description": "The container of pages in this blog.",
     "properties": {
      "selfLink": {
       "type": "string",
       "description": "The URL of the container for pages in this blog."
      },
      "totalItems": {
       "type": "integer",
       "description": "The count of pages in this blog.",
       "format": "int32"
      }
     }
    },
    "posts": {
     "type": "object",
     "description": "The container of posts in this blog.",
     "properties": {
      "selfLink": {
       "type": "string",
       "description": "The URL of the container for posts in this blog."
      },
      "totalItems": {
       "type": "integer",
       "description": "The count of posts in this blog.",
       "format": "int32"
      }
     }
    },
    "published": {
     "type": "string",
     "description": "RFC 3339 date-time when this blog was published.",
     "format": "date-time"
    },
    "selfLink": {
     "type": "string",
     "description": "The API REST URL to fetch this resource from."
    },
    "updated": {
     "type": "string",
     "description": "RFC 3339 date-time when this blog was last updated.",
     "format": "date-time"
    },
    "url": {
     "type": "string",
     "description": "The URL where this blog is published."
    }
   }
  },
  "BlogList": {
   "id": "BlogList",
   "type": "object",
   "properties": {
    "items": {
     "type": "array",
     "description": "The list of Blogs this user has Authorship or Admin rights over.",
     "items": {
      "$ref": "Blog"
     }
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#blogList",
     "default": "blogger#blogList"
    }
   }
  },
  "Comment": {
   "id": "Comment",
   "type": "object",
   "properties": {
    "author": {
     "type": "object",
     "description": "The author of this Comment.",
     "properties": {
      "displayName": {
       "type": "string",
       "description": "The display name."
      },
      "id": {
       "type": "string",
       "description": "The identifier of the Comment creator."
      },
      "image": {
       "type": "object",
       "description": "The comment creator's avatar.",
       "properties": {
        "url": {
         "type": "string",
         "description": "The comment creator's avatar URL."
        }
       }
      },
      "url": {
       "type": "string",
       "description": "The URL of the Comment creator's Profile page."
      }
     }
    },
    "blog": {
     "type": "object",
     "description": "Data about the blog containing this comment.",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identifier of the blog containing this comment.",
       "format": "int64"
      }
     }
    },
    "content": {
     "type": "string",
     "description": "The actual content of the comment. May include HTML markup."
    },
    "id": {
     "type": "string",
     "description": "The identifier for this resource.",
     "format": "int64"
    },
    "inReplyTo": {
     "type": "object",
     "description": "Data about the comment this is in reply to.",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identified of the parent of this comment.",
       "format": "int64"
      }
     }
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entry. Always blogger#comment",
     "default": "blogger#comment"
    },
    "post": {
     "type": "object",
     "description": "Data about the post containing this comment.",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identifier of the post containing this comment.",
       "format": "int64"
      }
     }
    },
    "published": {
     "type": "string",
     "description": "RFC 3339 date-time when this comment was published.",
     "format": "date-time"
    },
    "selfLink": {
     "type": "string",
     "description": "The API REST URL to fetch this resource from."
    },
    "updated": {
     "type": "string",
     "description": "RFC 3339 date-time when this comment was last updated.",
     "format": "date-time"
    }
   }
  },
  "CommentList": {
   "id": "CommentList",
   "type": "object",
   "properties": {
    "items": {
     "type": "array",
     "description": "The List of Comments for a Post.",
     "items": {
      "$ref": "Comment"
     }
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entry. Always blogger#commentList",
     "default": "blogger#commentList"
    },
    "nextPageToken": {
     "type": "string",
     "description": "Pagination token to fetch the next page, if one exists."
    },
    "prevPageToken": {
     "type": "string",
     "description": "Pagination token to fetch the previous page, if one exists."
    }
   }
  },
  "Page": {
   "id": "Page",
   "type": "object",
   "properties": {
    "author": {
     "type": "object",
     "description": "The author of this Page.",
     "properties": {
      "displayName": {
       "type": "string",
       "description": "The display name."
      },
      "id": {
       "type": "string",
       "description": "The identifier of the Page creator."
      },
      "image": {
       "type": "object",
       "description": "The page author's avatar.",
       "properties": {
        "url": {
         "type": "string",
         "description": "The page author's avatar URL."
        }
       }
      },
      "url": {
       "type": "string",
       "description": "The URL of the Page creator's Profile page."
      }
     }
    },
    "blog": {
     "type": "object",
     "description": "Data about the blog containing this Page.",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identifier of the blog containing this page.",
       "format": "int64"
      }
     }
    },
    "content": {
     "type": "string",
     "description": "The body content of this Page, in HTML."
    },
    "id": {
     "type": "string",
     "description": "The identifier for this resource.",
     "format": "int64"
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#page",
     "default": "blogger#page"
    },
    "published": {
     "type": "string",
     "description": "RFC 3339 date-time when this Page was published.",
     "format": "date-time"
    },
    "selfLink": {
     "type": "string",
     "description": "The API REST URL to fetch this resource from."
    },
    "title": {
     "type": "string",
     "description": "The title of this entity. This is the name displayed in the Admin user interface."
    },
    "updated": {
     "type": "string",
     "description": "RFC 3339 date-time when this Page was last updated.",
     "format": "date-time"
    },
    "url": {
     "type": "string",
     "description": "The URL that this Page is displayed at."
    }
   }
  },
  "PageList": {
   "id": "PageList",
   "type": "object",
   "properties": {
    "items": {
     "type": "array",
     "description": "The list of Pages for a Blog.",
     "items": {
      "$ref": "Page"
     }
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#pageList",
     "default": "blogger#pageList"
    }
   }
  },
  "Post": {
   "id": "Post",
   "type": "object",
   "properties": {
    "author": {
     "type": "object",
     "description": "The author of this Post.",
     "properties": {
      "displayName": {
       "type": "string",
       "description": "The display name."
      },
      "id": {
       "type": "string",
       "description": "The identifier of the Post creator."
      },
      "image": {
       "type": "object",
       "description": "The Post author's avatar.",
       "properties": {
        "url": {
         "type": "string",
         "description": "The Post author's avatar URL."
        }
       }
      },
      "url": {
       "type": "string",
       "description": "The URL of the Post creator's Profile page."
      }
     }
    },
    "blog": {
     "type": "object",
     "description": "Data about the blog containing this Post.",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identifier of the Blog that contains this Post.",
       "format": "int64"
      }
     }
    },
    "content": {
     "type": "string",
     "description": "The content of the Post. May contain HTML markup."
    },
    "id": {
     "type": "string",
     "description": "The identifier of this Post.",
     "format": "int64"
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#post",
     "default": "blogger#post"
    },
    "labels": {
     "type": "array",
     "description": "The list of labels this Post was tagged with.",
     "items": {
      "type": "string"
     }
    },
    "published": {
     "type": "string",
     "description": "RFC 3339 date-time when this Post was published.",
     "format": "date-time"
    },
    "replies": {
     "type": "object",
     "description": "The container of comments on this Post.",
     "properties": {
      "selfLink": {
       "type": "string",
       "description": "The URL of the comments on this post."
      },
      "totalItems": {
       "type": "string",
       "description": "The count of comments on this post.",
       "format": "int64"
      }
     }
    },
    "selfLink": {
     "type": "string",
     "description": "The API REST URL to fetch this resource from."
    },
    "title": {
     "type": "string",
     "description": "The title of the Post."
    },
    "updated": {
     "type": "string",
     "description": "RFC 3339 date-time when this Post was last updated.",
     "format": "date-time"
    },
    "url": {
     "type": "string",
     "description": "The URL where this Post is displayed."
    }
   }
  },
  "PostList": {
   "id": "PostList",
   "type": "object",
   "properties": {
    "items": {
     "type": "array",
     "description": "The list of Posts for this Blog.",
     "items": {
      "$ref": "Post"
     }
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#postList",
     "default": "blogger#postList"
    },
    "nextPageToken": {
     "type": "string",
     "description": "Pagination token to fetch the next page, if one exists."
    },
    "prevPageToken": {
     "type": "string",
     "description": "Pagination token to fetch the previous page, if one exists."
    }
   }
  },
  "User": {
   "id": "User",
   "type": "object",
   "properties": {
    "about": {
     "type": "string",
     "description": "Profile summary information."
    },
    "blogs": {
     "type": "object",
     "description": "The container of blogs for this user.",
     "properties": {
      "selfLink": {
       "type": "string",
       "description": "The URL of the Blogs for this user."
      }
     }
    },
    "created": {
     "type": "string",
     "description": "The timestamp of when this profile was created, in seconds since epoch.",
     "format": "date-time"
    },
    "displayName": {
     "type": "string",
     "description": "The display name."
    },
    "id": {
     "type": "string",
     "description": "The identifier for this User."
    },
    "kind": {
     "type": "string",
     "description": "The kind of this entity. Always blogger#user",
     "default": "blogger#user"
    },
    "locale": {
     "type": "object",
     "description": "This user's locale",
     "properties": {
      "country": {
       "type": "string",
       "description": "The user's country setting."
      },
      "language": {
       "type": "string",
       "description": "The user's language setting."
      },
      "variant": {
       "type": "string",
       "description": "The user's language variant setting."
      }
     }
    },
    "selfLink": {
     "type": "string",
     "description": "The API REST URL to fetch this resource from."
    },
    "url": {
     "type": "string",
     "description": "The user's profile page."
    }
   }
  }
 },
 "resources": {
  "blogs": {
   "methods": {
    "get": {
     "id": "blogger.blogs.get",
     "path": "blogs/{blogId}",
     "httpMethod": "GET",
     "description": "Gets one blog by id.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "The ID of the blog to get.",
       "required": true,
       "location": "path"
      }
     },
     "parameterOrder": [
      "blogId"
     ],
     "response": {
      "$ref": "Blog"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    }
   }
  },
  "comments": {
   "methods": {
    "get": {
     "id": "blogger.comments.get",
     "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}",
     "httpMethod": "GET",
     "description": "Gets one comment by id.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog to containing the comment.",
       "required": true,
       "location": "path"
      },
      "commentId": {
       "type": "string",
       "description": "The ID of the comment to get.",
       "required": true,
       "location": "path"
      },
      "postId": {
       "type": "string",
       "description": "ID of the post to fetch posts from.",
       "required": true,
       "location": "path"
      }
     },
     "parameterOrder": [
      "blogId",
      "postId",
      "commentId"
     ],
     "response": {
      "$ref": "Comment"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    },
    "list": {
     "id": "blogger.comments.list",
     "path": "blogs/{blogId}/posts/{postId}/comments",
     "httpMethod": "GET",
     "description": "Retrieves the comments for a blog, possibly filtered.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog to fetch comments from.",
       "required": true,
       "location": "path"
      },
      "fetchBodies": {
       "type": "boolean",
       "description": "Whether the body content of the comments is included.",
       "location": "query"
      },
      "maxResults": {
       "type": "integer",
       "description": "Maximum number of comments to include in the result.",
       "format": "uint32",
       "location": "query"
      },
      "pageToken": {
       "type": "string",
       "description": "Continuation token if request is paged.",
       "location": "query"
      },
      "postId": {
       "type": "string",
       "description": "ID of the post to fetch posts from.",
       "required": true,
       "location": "path"
      },
      "startDate": {
       "type": "string",
       "description": "Earliest date of comment to fetch, a date-time with RFC 3339 formatting.",
       "format": "date-time",
       "location": "query"
      }
     },
     "parameterOrder": [
      "blogId",
      "postId"
     ],
     "response": {
      "$ref": "CommentList"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    }
   }
  },
  "pages": {
   "methods": {
    "get": {
     "id": "blogger.pages.get",
     "path": "blogs/{blogId}/pages/{pageId}",
     "httpMethod": "GET",
     "description": "Gets one blog page by id.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog containing the page.",
       "required": true,
       "location": "path"
      },
      "pageId": {
       "type": "string",
       "description": "The ID of the page to get.",
       "required": true,
       "location": "path"
      }
     },
     "parameterOrder": [
      "blogId",
      "pageId"
     ],
     "response": {
      "$ref": "Page"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    },
    "list": {
     "id": "blogger.pages.list",
     "path": "blogs/{blogId}/pages",
     "httpMethod": "GET",
     "description": "Retrieves pages for a blog, possibly filtered.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog to fetch pages from.",
       "required": true,
       "location": "path"
      },
      "fetchBodies": {
       "type": "boolean",
       "description": "Whether to retrieve the Page bodies.",
       "location": "query"
      }
     },
     "parameterOrder": [
      "blogId"
     ],
     "response": {
      "$ref": "PageList"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    }
   }
  },
  "posts": {
   "methods": {
    "get": {
     "id": "blogger.posts.get",
     "path": "blogs/{blogId}/posts/{postId}",
     "httpMethod": "GET",
     "description": "Get a post by id.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog to fetch the post from.",
       "required": true,
       "location": "path"
      },
      "postId": {
       "type": "string",
       "description": "The ID of the post",
       "required": true,
       "location": "path"
      }
     },
     "parameterOrder": [
      "blogId",
      "postId"
     ],
     "response": {
      "$ref": "Post"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    },
    "list": {
     "id": "blogger.posts.list",
     "path": "blogs/{blogId}/posts",
     "httpMethod": "GET",
     "description": "Retrieves a list of posts, possibly filtered.",
     "parameters": {
      "blogId": {
       "type": "string",
       "description": "ID of the blog to fetch posts from.",
       "required": true,
       "location": "path"
      },
      "fetchBodies": {
       "type": "boolean",
       "description": "Whether the body content of posts is included.",
       "location": "query"
      },
      "maxResults": {
       "type": "integer",
       "description": "Maximum number of posts to fetch.",
       "format": "uint32",
       "location": "query"
      },
      "pageToken": {
       "type": "string",
       "description": "Continuation token if the request is paged.",
       "location": "query"
      },
      "startDate": {
       "type": "string",
       "description": "Earliest post date to fetch, a date-time with RFC 3339 formatting.",
       "format": "date-time",
       "location": "query"
      }
     },
     "parameterOrder": [
      "blogId"
     ],
     "response": {
      "$ref": "PostList"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    }
   }
  },
  "users": {
   "methods": {
    "get": {
     "id": "blogger.users.get",
     "path": "users/{userId}",
     "httpMethod": "GET",
     "description": "Gets one user by id.",
     "parameters": {
      "userId": {
       "type": "string",
       "description": "The ID of the user to get.",
       "required": true,
       "location": "path"
      }
     },
     "parameterOrder": [
      "userId"
     ],
     "response": {
      "$ref": "User"
     },
     "scopes": [
      "https://www.googleapis.com/auth/blogger"
     ]
    }
   },
   "resources": {
    "blogs": {
     "methods": {
      "list": {
       "id": "blogger.users.blogs.list",
       "path": "users/{userId}/blogs",
       "httpMethod": "GET",
       "description": "Retrieves a list of blogs, possibly filtered.",
       "parameters": {
        "userId": {
         "type": "string",
         "description": "ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.",
         "required": true,
         "location": "path"
        }
       },
       "parameterOrder": [
        "userId"
       ],
       "response": {
        "$ref": "BlogList"
       },
       "scopes": [
        "https://www.googleapis.com/auth/blogger"
       ]
      }
     }
    }
   }
  }
 }
}