googleapis
Version:
Google APIs Client Library for Node.js
492 lines (491 loc) • 15.7 kB
TypeScript
/**
* 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's locale
*/
locale: any;
/**
* The API REST URL to fetch this resource from.
*/
selfLink: string;
/**
* The user'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;
}