UNPKG

googleapis

Version:
492 lines (491 loc) 15.7 kB
/** * Copyright 2015 Google Inc. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import { AxiosPromise } from 'axios'; import { GoogleApis } from '../..'; import { BodyResponseCallback, GlobalOptions, MethodOptions } from '../../lib/api'; /** * Blogger API * * API for access to the data within Blogger. * * @example * const google = require('googleapis'); * const blogger = google.blogger('v2'); * * @namespace blogger * @type {Function} * @version v2 * @variation v2 * @param {object=} options Options for Blogger */ export declare class Blogger { _options: GlobalOptions; google: GoogleApis; root: this; blogs: Resource$Blogs; comments: Resource$Comments; pages: Resource$Pages; posts: Resource$Posts; users: Resource$Users; constructor(options: GlobalOptions, google: GoogleApis); getRoot(): this; } export interface Schema$Blog { /** * The description of this blog. This is displayed underneath the title. */ description: string; /** * The identifier for this resource. */ id: string; /** * The kind of this entry. Always blogger#blog */ kind: string; /** * The locale this Blog is set to. */ locale: any; /** * The name of this blog. This is displayed as the title. */ name: string; /** * The container of pages in this blog. */ pages: any; /** * The container of posts in this blog. */ posts: any; /** * RFC 3339 date-time when this blog was published. */ published: string; /** * The API REST URL to fetch this resource from. */ selfLink: string; /** * RFC 3339 date-time when this blog was last updated. */ updated: string; /** * The URL where this blog is published. */ url: string; } export interface Schema$BlogList { /** * The list of Blogs this user has Authorship or Admin rights over. */ items: Schema$Blog[]; /** * The kind of this entity. Always blogger#blogList */ kind: string; } export interface Schema$Comment { /** * The author of this Comment. */ author: any; /** * Data about the blog containing this comment. */ blog: any; /** * The actual content of the comment. May include HTML markup. */ content: string; /** * The identifier for this resource. */ id: string; /** * Data about the comment this is in reply to. */ inReplyTo: any; /** * The kind of this entry. Always blogger#comment */ kind: string; /** * Data about the post containing this comment. */ post: any; /** * RFC 3339 date-time when this comment was published. */ published: string; /** * The API REST URL to fetch this resource from. */ selfLink: string; /** * RFC 3339 date-time when this comment was last updated. */ updated: string; } export interface Schema$CommentList { /** * The List of Comments for a Post. */ items: Schema$Comment[]; /** * The kind of this entry. Always blogger#commentList */ kind: string; /** * Pagination token to fetch the next page, if one exists. */ nextPageToken: string; /** * Pagination token to fetch the previous page, if one exists. */ prevPageToken: string; } export interface Schema$Page { /** * The author of this Page. */ author: any; /** * Data about the blog containing this Page. */ blog: any; /** * The body content of this Page, in HTML. */ content: string; /** * The identifier for this resource. */ id: string; /** * The kind of this entity. Always blogger#page */ kind: string; /** * RFC 3339 date-time when this Page was published. */ published: string; /** * The API REST URL to fetch this resource from. */ selfLink: string; /** * The title of this entity. This is the name displayed in the Admin user * interface. */ title: string; /** * RFC 3339 date-time when this Page was last updated. */ updated: string; /** * The URL that this Page is displayed at. */ url: string; } export interface Schema$PageList { /** * The list of Pages for a Blog. */ items: Schema$Page[]; /** * The kind of this entity. Always blogger#pageList */ kind: string; } export interface Schema$Post { /** * The author of this Post. */ author: any; /** * Data about the blog containing this Post. */ blog: any; /** * The content of the Post. May contain HTML markup. */ content: string; /** * The identifier of this Post. */ id: string; /** * The kind of this entity. Always blogger#post */ kind: string; /** * The list of labels this Post was tagged with. */ labels: string[]; /** * RFC 3339 date-time when this Post was published. */ published: string; /** * The container of comments on this Post. */ replies: any; /** * The API REST URL to fetch this resource from. */ selfLink: string; /** * The title of the Post. */ title: string; /** * RFC 3339 date-time when this Post was last updated. */ updated: string; /** * The URL where this Post is displayed. */ url: string; } export interface Schema$PostList { /** * The list of Posts for this Blog. */ items: Schema$Post[]; /** * The kind of this entity. Always blogger#postList */ kind: string; /** * Pagination token to fetch the next page, if one exists. */ nextPageToken: string; /** * Pagination token to fetch the previous page, if one exists. */ prevPageToken: string; } export interface Schema$User { /** * Profile summary information. */ about: string; /** * The container of blogs for this user. */ blogs: any; /** * The timestamp of when this profile was created, in seconds since epoch. */ created: string; /** * The display name. */ displayName: string; /** * The identifier for this User. */ id: string; /** * The kind of this entity. Always blogger#user */ kind: string; /** * This user&#39;s locale */ locale: any; /** * The API REST URL to fetch this resource from. */ selfLink: string; /** * The user&#39;s profile page. */ url: string; } export declare class Resource$Blogs { root: Blogger; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.blogs.get * @desc Gets one blog by id. * @alias blogger.blogs.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId The ID of the blog to get. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: any, options?: MethodOptions): AxiosPromise<Schema$Blog>; get(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$Blog>, callback?: BodyResponseCallback<Schema$Blog>): void; } export declare class Resource$Comments { root: Blogger; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.comments.get * @desc Gets one comment by id. * @alias blogger.comments.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog to containing the comment. * @param {string} params.commentId The ID of the comment to get. * @param {string} params.postId ID of the post to fetch posts from. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: any, options?: MethodOptions): AxiosPromise<Schema$Comment>; get(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$Comment>, callback?: BodyResponseCallback<Schema$Comment>): void; /** * blogger.comments.list * @desc Retrieves the comments for a blog, possibly filtered. * @alias blogger.comments.list * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog to fetch comments from. * @param {boolean=} params.fetchBodies Whether the body content of the comments is included. * @param {integer=} params.maxResults Maximum number of comments to include in the result. * @param {string=} params.pageToken Continuation token if request is paged. * @param {string} params.postId ID of the post to fetch posts from. * @param {string=} params.startDate Earliest date of comment to fetch, a date-time with RFC 3339 formatting. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: any, options?: MethodOptions): AxiosPromise<Schema$CommentList>; list(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$CommentList>, callback?: BodyResponseCallback<Schema$CommentList>): void; } export declare class Resource$Pages { root: Blogger; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.pages.get * @desc Gets one blog page by id. * @alias blogger.pages.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog containing the page. * @param {string} params.pageId The ID of the page to get. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: any, options?: MethodOptions): AxiosPromise<Schema$Page>; get(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$Page>, callback?: BodyResponseCallback<Schema$Page>): void; /** * blogger.pages.list * @desc Retrieves pages for a blog, possibly filtered. * @alias blogger.pages.list * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog to fetch pages from. * @param {boolean=} params.fetchBodies Whether to retrieve the Page bodies. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: any, options?: MethodOptions): AxiosPromise<Schema$PageList>; list(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$PageList>, callback?: BodyResponseCallback<Schema$PageList>): void; } export declare class Resource$Posts { root: Blogger; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.posts.get * @desc Get a post by id. * @alias blogger.posts.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog to fetch the post from. * @param {string} params.postId The ID of the post * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: any, options?: MethodOptions): AxiosPromise<Schema$Post>; get(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$Post>, callback?: BodyResponseCallback<Schema$Post>): void; /** * blogger.posts.list * @desc Retrieves a list of posts, possibly filtered. * @alias blogger.posts.list * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.blogId ID of the blog to fetch posts from. * @param {boolean=} params.fetchBodies Whether the body content of posts is included. * @param {integer=} params.maxResults Maximum number of posts to fetch. * @param {string=} params.pageToken Continuation token if the request is paged. * @param {string=} params.startDate Earliest post date to fetch, a date-time with RFC 3339 formatting. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: any, options?: MethodOptions): AxiosPromise<Schema$PostList>; list(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$PostList>, callback?: BodyResponseCallback<Schema$PostList>): void; } export declare class Resource$Users { root: Blogger; blogs: Resource$Users$Blogs; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.users.get * @desc Gets one user by id. * @alias blogger.users.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.userId The ID of the user to get. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: any, options?: MethodOptions): AxiosPromise<Schema$User>; get(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$User>, callback?: BodyResponseCallback<Schema$User>): void; } export declare class Resource$Users$Blogs { root: Blogger; constructor(root: Blogger); getRoot(): Blogger; /** * blogger.users.blogs.list * @desc Retrieves a list of blogs, possibly filtered. * @alias blogger.users.blogs.list * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.userId ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: any, options?: MethodOptions): AxiosPromise<Schema$BlogList>; list(params?: any, options?: MethodOptions | BodyResponseCallback<Schema$BlogList>, callback?: BodyResponseCallback<Schema$BlogList>): void; }