1{
2 "kind": "discovery#restDescription",
3 "etag": "\"DGgqtFnjgu83tuwvvVNNUhOiHWk/HqXrvEeuZV7fVbX7lTgVYLdSy_g\"",
4 "discoveryVersion": "v1",
5 "id": "blogger:v3",
6 "name": "blogger",
7 "version": "v3",
8 "title": "Blogger API",
9 "description": "API for access to the data within Blogger.",
10 "ownerDomain": "google.com",
11 "ownerName": "Google",
12 "icons": {
13 "x16": "http://www.google.com/images/icons/product/blogger-16.png",
14 "x32": "http://www.google.com/images/icons/product/blogger-32.png"
15 },
16 "documentationLink": "https://developers.google.com/blogger/docs/3.0/getting_started",
17 "labels": [
18 "limited_availability"
19 ],
20 "protocol": "rest",
21 "baseUrl": "https://www.googleapis.com/blogger/v3/",
22 "basePath": "/blogger/v3/",
23 "rootUrl": "https://www.googleapis.com/",
24 "mtlsRootUrl": "https://www.mtls.googleapis.com/",
25 "servicePath": "blogger/v3/",
26 "batchPath": "batch",
27 "parameters": {
28 "alt": {
29 "type": "string",
30 "description": "Data format for the response.",
31 "default": "json",
32 "enum": [
33 "json"
34 ],
35 "enumDescriptions": [
36 "Responses with Content-Type of application/json"
37 ],
38 "location": "query"
39 },
40 "fields": {
41 "type": "string",
42 "description": "Selector specifying which fields to include in a partial response.",
43 "location": "query"
44 },
45 "key": {
46 "type": "string",
47 "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.",
48 "location": "query"
49 },
50 "oauth_token": {
51 "type": "string",
52 "description": "OAuth 2.0 token for the current user.",
53 "location": "query"
54 },
55 "prettyPrint": {
56 "type": "boolean",
57 "description": "Returns response with indentations and line breaks.",
58 "default": "true",
59 "location": "query"
60 },
61 "quotaUser": {
62 "type": "string",
63 "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.",
64 "location": "query"
65 },
66 "userIp": {
67 "type": "string",
68 "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
69 "location": "query"
70 }
71 },
72 "auth": {
73 "oauth2": {
74 "scopes": {
75 "https://www.googleapis.com/auth/blogger": {
76 "description": "Manage your Blogger account"
77 },
78 "https://www.googleapis.com/auth/blogger.readonly": {
79 "description": "View your Blogger account"
80 }
81 }
82 }
83 },
84 "schemas": {
85 "Blog": {
86 "id": "Blog",
87 "type": "object",
88 "properties": {
89 "customMetaData": {
90 "type": "string",
91 "description": "The JSON custom meta-data for the Blog"
92 },
93 "description": {
94 "type": "string",
95 "description": "The description of this blog. This is displayed underneath the title."
96 },
97 "id": {
98 "type": "string",
99 "description": "The identifier for this resource."
100 },
101 "kind": {
102 "type": "string",
103 "description": "The kind of this entry. Always blogger#blog",
104 "default": "blogger#blog"
105 },
106 "locale": {
107 "type": "object",
108 "description": "The locale this Blog is set to.",
109 "properties": {
110 "country": {
111 "type": "string",
112 "description": "The country this blog's locale is set to."
113 },
114 "language": {
115 "type": "string",
116 "description": "The language this blog is authored in."
117 },
118 "variant": {
119 "type": "string",
120 "description": "The language variant this blog is authored in."
121 }
122 }
123 },
124 "name": {
125 "type": "string",
126 "description": "The name of this blog. This is displayed as the title."
127 },
128 "pages": {
129 "type": "object",
130 "description": "The container of pages in this blog.",
131 "properties": {
132 "selfLink": {
133 "type": "string",
134 "description": "The URL of the container for pages in this blog."
135 },
136 "totalItems": {
137 "type": "integer",
138 "description": "The count of pages in this blog.",
139 "format": "int32"
140 }
141 }
142 },
143 "posts": {
144 "type": "object",
145 "description": "The container of posts in this blog.",
146 "properties": {
147 "items": {
148 "type": "array",
149 "description": "The List of Posts for this Blog.",
150 "items": {
151 "$ref": "Post"
152 }
153 },
154 "selfLink": {
155 "type": "string",
156 "description": "The URL of the container for posts in this blog."
157 },
158 "totalItems": {
159 "type": "integer",
160 "description": "The count of posts in this blog.",
161 "format": "int32"
162 }
163 }
164 },
165 "published": {
166 "type": "string",
167 "description": "RFC 3339 date-time when this blog was published.",
168 "format": "date-time"
169 },
170 "selfLink": {
171 "type": "string",
172 "description": "The API REST URL to fetch this resource from."
173 },
174 "updated": {
175 "type": "string",
176 "description": "RFC 3339 date-time when this blog was last updated.",
177 "format": "date-time"
178 },
179 "url": {
180 "type": "string",
181 "description": "The URL where this blog is published."
182 }
183 }
184 },
185 "BlogList": {
186 "id": "BlogList",
187 "type": "object",
188 "properties": {
189 "blogUserInfos": {
190 "type": "array",
191 "description": "Admin level list of blog per-user information",
192 "items": {
193 "$ref": "BlogUserInfo"
194 }
195 },
196 "items": {
197 "type": "array",
198 "description": "The list of Blogs this user has Authorship or Admin rights over.",
199 "items": {
200 "$ref": "Blog"
201 }
202 },
203 "kind": {
204 "type": "string",
205 "description": "The kind of this entity. Always blogger#blogList",
206 "default": "blogger#blogList"
207 }
208 }
209 },
210 "BlogPerUserInfo": {
211 "id": "BlogPerUserInfo",
212 "type": "object",
213 "properties": {
214 "blogId": {
215 "type": "string",
216 "description": "ID of the Blog resource"
217 },
218 "hasAdminAccess": {
219 "type": "boolean",
220 "description": "True if the user has Admin level access to the blog."
221 },
222 "kind": {
223 "type": "string",
224 "description": "The kind of this entity. Always blogger#blogPerUserInfo",
225 "default": "blogger#blogPerUserInfo"
226 },
227 "photosAlbumKey": {
228 "type": "string",
229 "description": "The Photo Album Key for the user when adding photos to the blog"
230 },
231 "userId": {
232 "type": "string",
233 "description": "ID of the User"
234 }
235 }
236 },
237 "BlogUserInfo": {
238 "id": "BlogUserInfo",
239 "type": "object",
240 "properties": {
241 "blog": {
242 "$ref": "Blog",
243 "description": "The Blog resource."
244 },
245 "blog_user_info": {
246 "$ref": "BlogPerUserInfo",
247 "description": "Information about a User for the Blog."
248 },
249 "kind": {
250 "type": "string",
251 "description": "The kind of this entity. Always blogger#blogUserInfo",
252 "default": "blogger#blogUserInfo"
253 }
254 }
255 },
256 "Comment": {
257 "id": "Comment",
258 "type": "object",
259 "properties": {
260 "author": {
261 "type": "object",
262 "description": "The author of this Comment.",
263 "properties": {
264 "displayName": {
265 "type": "string",
266 "description": "The display name."
267 },
268 "id": {
269 "type": "string",
270 "description": "The identifier of the Comment creator."
271 },
272 "image": {
273 "type": "object",
274 "description": "The comment creator's avatar.",
275 "properties": {
276 "url": {
277 "type": "string",
278 "description": "The comment creator's avatar URL."
279 }
280 }
281 },
282 "url": {
283 "type": "string",
284 "description": "The URL of the Comment creator's Profile page."
285 }
286 }
287 },
288 "blog": {
289 "type": "object",
290 "description": "Data about the blog containing this comment.",
291 "properties": {
292 "id": {
293 "type": "string",
294 "description": "The identifier of the blog containing this comment."
295 }
296 }
297 },
298 "content": {
299 "type": "string",
300 "description": "The actual content of the comment. May include HTML markup."
301 },
302 "id": {
303 "type": "string",
304 "description": "The identifier for this resource."
305 },
306 "inReplyTo": {
307 "type": "object",
308 "description": "Data about the comment this is in reply to.",
309 "properties": {
310 "id": {
311 "type": "string",
312 "description": "The identified of the parent of this comment."
313 }
314 }
315 },
316 "kind": {
317 "type": "string",
318 "description": "The kind of this entry. Always blogger#comment",
319 "default": "blogger#comment"
320 },
321 "post": {
322 "type": "object",
323 "description": "Data about the post containing this comment.",
324 "properties": {
325 "id": {
326 "type": "string",
327 "description": "The identifier of the post containing this comment."
328 }
329 }
330 },
331 "published": {
332 "type": "string",
333 "description": "RFC 3339 date-time when this comment was published.",
334 "format": "date-time"
335 },
336 "selfLink": {
337 "type": "string",
338 "description": "The API REST URL to fetch this resource from."
339 },
340 "status": {
341 "type": "string",
342 "description": "The status of the comment (only populated for admin users)"
343 },
344 "updated": {
345 "type": "string",
346 "description": "RFC 3339 date-time when this comment was last updated.",
347 "format": "date-time"
348 }
349 }
350 },
351 "CommentList": {
352 "id": "CommentList",
353 "type": "object",
354 "properties": {
355 "items": {
356 "type": "array",
357 "description": "The List of Comments for a Post.",
358 "items": {
359 "$ref": "Comment"
360 }
361 },
362 "kind": {
363 "type": "string",
364 "description": "The kind of this entry. Always blogger#commentList",
365 "default": "blogger#commentList"
366 },
367 "nextPageToken": {
368 "type": "string",
369 "description": "Pagination token to fetch the next page, if one exists."
370 },
371 "prevPageToken": {
372 "type": "string",
373 "description": "Pagination token to fetch the previous page, if one exists."
374 }
375 }
376 },
377 "Page": {
378 "id": "Page",
379 "type": "object",
380 "properties": {
381 "author": {
382 "type": "object",
383 "description": "The author of this Page.",
384 "properties": {
385 "displayName": {
386 "type": "string",
387 "description": "The display name."
388 },
389 "id": {
390 "type": "string",
391 "description": "The identifier of the Page creator."
392 },
393 "image": {
394 "type": "object",
395 "description": "The page author's avatar.",
396 "properties": {
397 "url": {
398 "type": "string",
399 "description": "The page author's avatar URL."
400 }
401 }
402 },
403 "url": {
404 "type": "string",
405 "description": "The URL of the Page creator's Profile page."
406 }
407 }
408 },
409 "blog": {
410 "type": "object",
411 "description": "Data about the blog containing this Page.",
412 "properties": {
413 "id": {
414 "type": "string",
415 "description": "The identifier of the blog containing this page."
416 }
417 }
418 },
419 "content": {
420 "type": "string",
421 "description": "The body content of this Page, in HTML."
422 },
423 "id": {
424 "type": "string",
425 "description": "The identifier for this resource."
426 },
427 "kind": {
428 "type": "string",
429 "description": "The kind of this entity. Always blogger#page",
430 "default": "blogger#page"
431 },
432 "published": {
433 "type": "string",
434 "description": "RFC 3339 date-time when this Page was published.",
435 "format": "date-time"
436 },
437 "selfLink": {
438 "type": "string",
439 "description": "The API REST URL to fetch this resource from."
440 },
441 "status": {
442 "type": "string",
443 "description": "The status of the page for admin resources (either LIVE or DRAFT)."
444 },
445 "title": {
446 "type": "string",
447 "description": "The title of this entity. This is the name displayed in the Admin user interface."
448 },
449 "updated": {
450 "type": "string",
451 "description": "RFC 3339 date-time when this Page was last updated.",
452 "format": "date-time"
453 },
454 "url": {
455 "type": "string",
456 "description": "The URL that this Page is displayed at."
457 }
458 }
459 },
460 "PageList": {
461 "id": "PageList",
462 "type": "object",
463 "properties": {
464 "items": {
465 "type": "array",
466 "description": "The list of Pages for a Blog.",
467 "items": {
468 "$ref": "Page"
469 }
470 },
471 "kind": {
472 "type": "string",
473 "description": "The kind of this entity. Always blogger#pageList",
474 "default": "blogger#pageList"
475 }
476 }
477 },
478 "Pageviews": {
479 "id": "Pageviews",
480 "type": "object",
481 "properties": {
482 "blogId": {
483 "type": "string",
484 "description": "Blog Id",
485 "format": "int64"
486 },
487 "counts": {
488 "type": "array",
489 "description": "The container of posts in this blog.",
490 "items": {
491 "type": "object",
492 "properties": {
493 "count": {
494 "type": "string",
495 "description": "Count of page views for the given time range",
496 "format": "int64"
497 },
498 "timeRange": {
499 "type": "string",
500 "description": "Time range the given count applies to"
501 }
502 }
503 }
504 },
505 "kind": {
506 "type": "string",
507 "description": "The kind of this entry. Always blogger#page_views",
508 "default": "blogger#page_views"
509 }
510 }
511 },
512 "Post": {
513 "id": "Post",
514 "type": "object",
515 "properties": {
516 "author": {
517 "type": "object",
518 "description": "The author of this Post.",
519 "properties": {
520 "displayName": {
521 "type": "string",
522 "description": "The display name."
523 },
524 "id": {
525 "type": "string",
526 "description": "The identifier of the Post creator."
527 },
528 "image": {
529 "type": "object",
530 "description": "The Post author's avatar.",
531 "properties": {
532 "url": {
533 "type": "string",
534 "description": "The Post author's avatar URL."
535 }
536 }
537 },
538 "url": {
539 "type": "string",
540 "description": "The URL of the Post creator's Profile page."
541 }
542 }
543 },
544 "blog": {
545 "type": "object",
546 "description": "Data about the blog containing this Post.",
547 "properties": {
548 "id": {
549 "type": "string",
550 "description": "The identifier of the Blog that contains this Post."
551 }
552 }
553 },
554 "content": {
555 "type": "string",
556 "description": "The content of the Post. May contain HTML markup."
557 },
558 "customMetaData": {
559 "type": "string",
560 "description": "The JSON meta-data for the Post."
561 },
562 "id": {
563 "type": "string",
564 "description": "The identifier of this Post."
565 },
566 "images": {
567 "type": "array",
568 "description": "Display image for the Post.",
569 "items": {
570 "type": "object",
571 "properties": {
572 "url": {
573 "type": "string"
574 }
575 }
576 }
577 },
578 "kind": {
579 "type": "string",
580 "description": "The kind of this entity. Always blogger#post",
581 "default": "blogger#post"
582 },
583 "labels": {
584 "type": "array",
585 "description": "The list of labels this Post was tagged with.",
586 "items": {
587 "type": "string"
588 }
589 },
590 "location": {
591 "type": "object",
592 "description": "The location for geotagged posts.",
593 "properties": {
594 "lat": {
595 "type": "number",
596 "description": "Location's latitude.",
597 "format": "double"
598 },
599 "lng": {
600 "type": "number",
601 "description": "Location's longitude.",
602 "format": "double"
603 },
604 "name": {
605 "type": "string",
606 "description": "Location name."
607 },
608 "span": {
609 "type": "string",
610 "description": "Location's viewport span. Can be used when rendering a map preview."
611 }
612 }
613 },
614 "published": {
615 "type": "string",
616 "description": "RFC 3339 date-time when this Post was published.",
617 "format": "date-time"
618 },
619 "replies": {
620 "type": "object",
621 "description": "The container of comments on this Post.",
622 "properties": {
623 "items": {
624 "type": "array",
625 "description": "The List of Comments for this Post.",
626 "items": {
627 "$ref": "Comment"
628 }
629 },
630 "selfLink": {
631 "type": "string",
632 "description": "The URL of the comments on this post."
633 },
634 "totalItems": {
635 "type": "string",
636 "description": "The count of comments on this post.",
637 "format": "int64"
638 }
639 }
640 },
641 "selfLink": {
642 "type": "string",
643 "description": "The API REST URL to fetch this resource from."
644 },
645 "status": {
646 "type": "string",
647 "description": "Status of the post. Only set for admin-level requests"
648 },
649 "title": {
650 "type": "string",
651 "description": "The title of the Post."
652 },
653 "titleLink": {
654 "type": "string",
655 "description": "The title link URL, similar to atom's related link."
656 },
657 "updated": {
658 "type": "string",
659 "description": "RFC 3339 date-time when this Post was last updated.",
660 "format": "date-time"
661 },
662 "url": {
663 "type": "string",
664 "description": "The URL where this Post is displayed."
665 }
666 }
667 },
668 "PostList": {
669 "id": "PostList",
670 "type": "object",
671 "properties": {
672 "items": {
673 "type": "array",
674 "description": "The list of Posts for this Blog.",
675 "items": {
676 "$ref": "Post"
677 }
678 },
679 "kind": {
680 "type": "string",
681 "description": "The kind of this entity. Always blogger#postList",
682 "default": "blogger#postList"
683 },
684 "nextPageToken": {
685 "type": "string",
686 "description": "Pagination token to fetch the next page, if one exists."
687 }
688 }
689 },
690 "PostPerUserInfo": {
691 "id": "PostPerUserInfo",
692 "type": "object",
693 "properties": {
694 "blogId": {
695 "type": "string",
696 "description": "ID of the Blog that the post resource belongs to."
697 },
698 "hasEditAccess": {
699 "type": "boolean",
700 "description": "True if the user has Author level access to the post."
701 },
702 "kind": {
703 "type": "string",
704 "description": "The kind of this entity. Always blogger#postPerUserInfo",
705 "default": "blogger#postPerUserInfo"
706 },
707 "postId": {
708 "type": "string",
709 "description": "ID of the Post resource."
710 },
711 "userId": {
712 "type": "string",
713 "description": "ID of the User."
714 }
715 }
716 },
717 "PostUserInfo": {
718 "id": "PostUserInfo",
719 "type": "object",
720 "properties": {
721 "kind": {
722 "type": "string",
723 "description": "The kind of this entity. Always blogger#postUserInfo",
724 "default": "blogger#postUserInfo"
725 },
726 "post": {
727 "$ref": "Post",
728 "description": "The Post resource."
729 },
730 "post_user_info": {
731 "$ref": "PostPerUserInfo",
732 "description": "Information about a User for the Post."
733 }
734 }
735 },
736 "PostUserInfosList": {
737 "id": "PostUserInfosList",
738 "type": "object",
739 "properties": {
740 "items": {
741 "type": "array",
742 "description": "The list of Posts with User information for the post, for this Blog.",
743 "items": {
744 "$ref": "PostUserInfo"
745 }
746 },
747 "kind": {
748 "type": "string",
749 "description": "The kind of this entity. Always blogger#postList",
750 "default": "blogger#postUserInfosList"
751 },
752 "nextPageToken": {
753 "type": "string",
754 "description": "Pagination token to fetch the next page, if one exists."
755 }
756 }
757 },
758 "User": {
759 "id": "User",
760 "type": "object",
761 "properties": {
762 "about": {
763 "type": "string",
764 "description": "Profile summary information."
765 },
766 "blogs": {
767 "type": "object",
768 "description": "The container of blogs for this user.",
769 "properties": {
770 "selfLink": {
771 "type": "string",
772 "description": "The URL of the Blogs for this user."
773 }
774 }
775 },
776 "created": {
777 "type": "string",
778 "description": "The timestamp of when this profile was created, in seconds since epoch.",
779 "format": "date-time"
780 },
781 "displayName": {
782 "type": "string",
783 "description": "The display name."
784 },
785 "id": {
786 "type": "string",
787 "description": "The identifier for this User."
788 },
789 "kind": {
790 "type": "string",
791 "description": "The kind of this entity. Always blogger#user",
792 "default": "blogger#user"
793 },
794 "locale": {
795 "type": "object",
796 "description": "This user's locale",
797 "properties": {
798 "country": {
799 "type": "string",
800 "description": "The user's country setting."
801 },
802 "language": {
803 "type": "string",
804 "description": "The user's language setting."
805 },
806 "variant": {
807 "type": "string",
808 "description": "The user's language variant setting."
809 }
810 }
811 },
812 "selfLink": {
813 "type": "string",
814 "description": "The API REST URL to fetch this resource from."
815 },
816 "url": {
817 "type": "string",
818 "description": "The user's profile page."
819 }
820 }
821 }
822 },
823 "resources": {
824 "blogUserInfos": {
825 "methods": {
826 "get": {
827 "id": "blogger.blogUserInfos.get",
828 "path": "users/{userId}/blogs/{blogId}",
829 "httpMethod": "GET",
830 "description": "Gets one blog and user info pair by blogId and userId.",
831 "parameters": {
832 "blogId": {
833 "type": "string",
834 "description": "The ID of the blog to get.",
835 "required": true,
836 "location": "path"
837 },
838 "maxPosts": {
839 "type": "integer",
840 "description": "Maximum number of posts to pull back with the blog.",
841 "format": "uint32",
842 "location": "query"
843 },
844 "userId": {
845 "type": "string",
846 "description": "ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.",
847 "required": true,
848 "location": "path"
849 }
850 },
851 "parameterOrder": [
852 "userId",
853 "blogId"
854 ],
855 "response": {
856 "$ref": "BlogUserInfo"
857 },
858 "scopes": [
859 "https://www.googleapis.com/auth/blogger",
860 "https://www.googleapis.com/auth/blogger.readonly"
861 ]
862 }
863 }
864 },
865 "blogs": {
866 "methods": {
867 "get": {
868 "id": "blogger.blogs.get",
869 "path": "blogs/{blogId}",
870 "httpMethod": "GET",
871 "description": "Gets one blog by id.",
872 "parameters": {
873 "blogId": {
874 "type": "string",
875 "description": "The ID of the blog to get.",
876 "required": true,
877 "location": "path"
878 },
879 "maxPosts": {
880 "type": "integer",
881 "description": "Maximum number of posts to pull back with the blog.",
882 "format": "uint32",
883 "location": "query"
884 }
885 },
886 "parameterOrder": [
887 "blogId"
888 ],
889 "response": {
890 "$ref": "Blog"
891 },
892 "scopes": [
893 "https://www.googleapis.com/auth/blogger",
894 "https://www.googleapis.com/auth/blogger.readonly"
895 ]
896 },
897 "getByUrl": {
898 "id": "blogger.blogs.getByUrl",
899 "path": "blogs/byurl",
900 "httpMethod": "GET",
901 "description": "Retrieve a Blog by URL.",
902 "parameters": {
903 "url": {
904 "type": "string",
905 "description": "The URL of the blog to retrieve.",
906 "required": true,
907 "location": "query"
908 }
909 },
910 "parameterOrder": [
911 "url"
912 ],
913 "response": {
914 "$ref": "Blog"
915 },
916 "scopes": [
917 "https://www.googleapis.com/auth/blogger",
918 "https://www.googleapis.com/auth/blogger.readonly"
919 ]
920 },
921 "listByUser": {
922 "id": "blogger.blogs.listByUser",
923 "path": "users/{userId}/blogs",
924 "httpMethod": "GET",
925 "description": "Retrieves a list of blogs, possibly filtered.",
926 "parameters": {
927 "fetchUserInfo": {
928 "type": "boolean",
929 "description": "Whether the response is a list of blogs with per-user information instead of just blogs.",
930 "location": "query"
931 },
932 "userId": {
933 "type": "string",
934 "description": "ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.",
935 "required": true,
936 "location": "path"
937 },
938 "view": {
939 "type": "string",
940 "enum": [
941 "ADMIN",
942 "AUTHOR",
943 "READER"
944 ],
945 "enumDescriptions": [
946 "Admin level detail",
947 "Author level detail",
948 "Admin level detail"
949 ],
950 "location": "query"
951 }
952 },
953 "parameterOrder": [
954 "userId"
955 ],
956 "response": {
957 "$ref": "BlogList"
958 },
959 "scopes": [
960 "https://www.googleapis.com/auth/blogger",
961 "https://www.googleapis.com/auth/blogger.readonly"
962 ]
963 }
964 }
965 },
966 "comments": {
967 "methods": {
968 "approve": {
969 "id": "blogger.comments.approve",
970 "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/approve",
971 "httpMethod": "POST",
972 "description": "Marks a comment as not spam.",
973 "parameters": {
974 "blogId": {
975 "type": "string",
976 "description": "The Id of the Blog.",
977 "required": true,
978 "location": "path"
979 },
980 "commentId": {
981 "type": "string",
982 "description": "The ID of the comment to mark as not spam.",
983 "required": true,
984 "location": "path"
985 },
986 "postId": {
987 "type": "string",
988 "description": "The ID of the Post.",
989 "required": true,
990 "location": "path"
991 }
992 },
993 "parameterOrder": [
994 "blogId",
995 "postId",
996 "commentId"
997 ],
998 "response": {
999 "$ref": "Comment"
1000 },
1001 "scopes": [
1002 "https://www.googleapis.com/auth/blogger"
1003 ]
1004 },
1005 "delete": {
1006 "id": "blogger.comments.delete",
1007 "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}",
1008 "httpMethod": "DELETE",
1009 "description": "Delete a comment by id.",
1010 "parameters": {
1011 "blogId": {
1012 "type": "string",
1013 "description": "The Id of the Blog.",
1014 "required": true,
1015 "location": "path"
1016 },
1017 "commentId": {
1018 "type": "string",
1019 "description": "The ID of the comment to delete.",
1020 "required": true,
1021 "location": "path"
1022 },
1023 "postId": {
1024 "type": "string",
1025 "description": "The ID of the Post.",
1026 "required": true,
1027 "location": "path"
1028 }
1029 },
1030 "parameterOrder": [
1031 "blogId",
1032 "postId",
1033 "commentId"
1034 ],
1035 "scopes": [
1036 "https://www.googleapis.com/auth/blogger"
1037 ]
1038 },
1039 "get": {
1040 "id": "blogger.comments.get",
1041 "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}",
1042 "httpMethod": "GET",
1043 "description": "Gets one comment by id.",
1044 "parameters": {
1045 "blogId": {
1046 "type": "string",
1047 "description": "ID of the blog to containing the comment.",
1048 "required": true,
1049 "location": "path"
1050 },
1051 "commentId": {
1052 "type": "string",
1053 "description": "The ID of the comment to get.",
1054 "required": true,
1055 "location": "path"
1056 },
1057 "postId": {
1058 "type": "string",
1059 "description": "ID of the post to fetch posts from.",
1060 "required": true,
1061 "location": "path"
1062 }
1063 },
1064 "parameterOrder": [
1065 "blogId",
1066 "postId",
1067 "commentId"
1068 ],
1069 "response": {
1070 "$ref": "Comment"
1071 },
1072 "scopes": [
1073 "https://www.googleapis.com/auth/blogger",
1074 "https://www.googleapis.com/auth/blogger.readonly"
1075 ]
1076 },
1077 "list": {
1078 "id": "blogger.comments.list",
1079 "path": "blogs/{blogId}/posts/{postId}/comments",
1080 "httpMethod": "GET",
1081 "description": "Retrieves the comments for a post, possibly filtered.",
1082 "parameters": {
1083 "blogId": {
1084 "type": "string",
1085 "description": "ID of the blog to fetch comments from.",
1086 "required": true,
1087 "location": "path"
1088 },
1089 "endDate": {
1090 "type": "string",
1091 "description": "Latest date of comment to fetch, a date-time with RFC 3339 formatting.",
1092 "format": "date-time",
1093 "location": "query"
1094 },
1095 "fetchBodies": {
1096 "type": "boolean",
1097 "description": "Whether the body content of the comments is included.",
1098 "location": "query"
1099 },
1100 "maxResults": {
1101 "type": "integer",
1102 "description": "Maximum number of comments to include in the result.",
1103 "format": "uint32",
1104 "location": "query"
1105 },
1106 "pageToken": {
1107 "type": "string",
1108 "description": "Continuation token if request is paged.",
1109 "location": "query"
1110 },
1111 "postId": {
1112 "type": "string",
1113 "description": "ID of the post to fetch posts from.",
1114 "required": true,
1115 "location": "path"
1116 },
1117 "startDate": {
1118 "type": "string",
1119 "description": "Earliest date of comment to fetch, a date-time with RFC 3339 formatting.",
1120 "format": "date-time",
1121 "location": "query"
1122 },
1123 "statuses": {
1124 "type": "string",
1125 "enum": [
1126 "emptied",
1127 "live",
1128 "pending",
1129 "spam"
1130 ],
1131 "enumDescriptions": [
1132 "Comments that have had their content removed",
1133 "Comments that are publicly visible",
1134 "Comments that are awaiting administrator approval",
1135 "Comments marked as spam by the administrator"
1136 ],
1137 "repeated": true,
1138 "location": "query"
1139 },
1140 "view": {
1141 "type": "string",
1142 "enum": [
1143 "ADMIN",
1144 "AUTHOR",
1145 "READER"
1146 ],
1147 "enumDescriptions": [
1148 "Admin level detail",
1149 "Author level detail",
1150 "Admin level detail"
1151 ],
1152 "location": "query"
1153 }
1154 },
1155 "parameterOrder": [
1156 "blogId",
1157 "postId"
1158 ],
1159 "response": {
1160 "$ref": "CommentList"
1161 },
1162 "scopes": [
1163 "https://www.googleapis.com/auth/blogger",
1164 "https://www.googleapis.com/auth/blogger.readonly"
1165 ]
1166 },
1167 "listByBlog": {
1168 "id": "blogger.comments.listByBlog",
1169 "path": "blogs/{blogId}/comments",
1170 "httpMethod": "GET",
1171 "description": "Retrieves the comments for a blog, across all posts, possibly filtered.",
1172 "parameters": {
1173 "blogId": {
1174 "type": "string",
1175 "description": "ID of the blog to fetch comments from.",
1176 "required": true,
1177 "location": "path"
1178 },
1179 "endDate": {
1180 "type": "string",
1181 "description": "Latest date of comment to fetch, a date-time with RFC 3339 formatting.",
1182 "format": "date-time",
1183 "location": "query"
1184 },
1185 "fetchBodies": {
1186 "type": "boolean",
1187 "description": "Whether the body content of the comments is included.",
1188 "location": "query"
1189 },
1190 "maxResults": {
1191 "type": "integer",
1192 "description": "Maximum number of comments to include in the result.",
1193 "format": "uint32",
1194 "location": "query"
1195 },
1196 "pageToken": {
1197 "type": "string",
1198 "description": "Continuation token if request is paged.",
1199 "location": "query"
1200 },
1201 "startDate": {
1202 "type": "string",
1203 "description": "Earliest date of comment to fetch, a date-time with RFC 3339 formatting.",
1204 "format": "date-time",
1205 "location": "query"
1206 }
1207 },
1208 "parameterOrder": [
1209 "blogId"
1210 ],
1211 "response": {
1212 "$ref": "CommentList"
1213 },
1214 "scopes": [
1215 "https://www.googleapis.com/auth/blogger",
1216 "https://www.googleapis.com/auth/blogger.readonly"
1217 ]
1218 },
1219 "markAsSpam": {
1220 "id": "blogger.comments.markAsSpam",
1221 "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/spam",
1222 "httpMethod": "POST",
1223 "description": "Marks a comment as spam.",
1224 "parameters": {
1225 "blogId": {
1226 "type": "string",
1227 "description": "The Id of the Blog.",
1228 "required": true,
1229 "location": "path"
1230 },
1231 "commentId": {
1232 "type": "string",
1233 "description": "The ID of the comment to mark as spam.",
1234 "required": true,
1235 "location": "path"
1236 },
1237 "postId": {
1238 "type": "string",
1239 "description": "The ID of the Post.",
1240 "required": true,
1241 "location": "path"
1242 }
1243 },
1244 "parameterOrder": [
1245 "blogId",
1246 "postId",
1247 "commentId"
1248 ],
1249 "response": {
1250 "$ref": "Comment"
1251 },
1252 "scopes": [
1253 "https://www.googleapis.com/auth/blogger"
1254 ]
1255 },
1256 "removeContent": {
1257 "id": "blogger.comments.removeContent",
1258 "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/removecontent",
1259 "httpMethod": "POST",
1260 "description": "Removes the content of a comment.",
1261 "parameters": {
1262 "blogId": {
1263 "type": "string",
1264 "description": "The Id of the Blog.",
1265 "required": true,
1266 "location": "path"
1267 },
1268 "commentId": {
1269 "type": "string",
1270 "description": "The ID of the comment to delete content from.",
1271 "required": true,
1272 "location": "path"
1273 },
1274 "postId": {
1275 "type": "string",
1276 "description": "The ID of the Post.",
1277 "required": true,
1278 "location": "path"
1279 }
1280 },
1281 "parameterOrder": [
1282 "blogId",
1283 "postId",
1284 "commentId"
1285 ],
1286 "response": {
1287 "$ref": "Comment"
1288 },
1289 "scopes": [
1290 "https://www.googleapis.com/auth/blogger"
1291 ]
1292 }
1293 }
1294 },
1295 "pageViews": {
1296 "methods": {
1297 "get": {
1298 "id": "blogger.pageViews.get",
1299 "path": "blogs/{blogId}/pageviews",
1300 "httpMethod": "GET",
1301 "description": "Retrieve pageview stats for a Blog.",
1302 "parameters": {
1303 "blogId": {
1304 "type": "string",
1305 "description": "The ID of the blog to get.",
1306 "required": true,
1307 "location": "path"
1308 },
1309 "range": {
1310 "type": "string",
1311 "enum": [
1312 "30DAYS",
1313 "7DAYS",
1314 "all"
1315 ],
1316 "enumDescriptions": [
1317 "Page view counts from the last thirty days.",
1318 "Page view counts from the last seven days.",
1319 "Total page view counts from all time."
1320 ],
1321 "repeated": true,
1322 "location": "query"
1323 }
1324 },
1325 "parameterOrder": [
1326 "blogId"
1327 ],
1328 "response": {
1329 "$ref": "Pageviews"
1330 },
1331 "scopes": [
1332 "https://www.googleapis.com/auth/blogger"
1333 ]
1334 }
1335 }
1336 },
1337 "pages": {
1338 "methods": {
1339 "delete": {
1340 "id": "blogger.pages.delete",
1341 "path": "blogs/{blogId}/pages/{pageId}",
1342 "httpMethod": "DELETE",
1343 "description": "Delete a page by id.",
1344 "parameters": {
1345 "blogId": {
1346 "type": "string",
1347 "description": "The Id of the Blog.",
1348 "required": true,
1349 "location": "path"
1350 },
1351 "pageId": {
1352 "type": "string",
1353 "description": "The ID of the Page.",
1354 "required": true,
1355 "location": "path"
1356 }
1357 },
1358 "parameterOrder": [
1359 "blogId",
1360 "pageId"
1361 ],
1362 "scopes": [
1363 "https://www.googleapis.com/auth/blogger"
1364 ]
1365 },
1366 "get": {
1367 "id": "blogger.pages.get",
1368 "path": "blogs/{blogId}/pages/{pageId}",
1369 "httpMethod": "GET",
1370 "description": "Gets one blog page by id.",
1371 "parameters": {
1372 "blogId": {
1373 "type": "string",
1374 "description": "ID of the blog containing the page.",
1375 "required": true,
1376 "location": "path"
1377 },
1378 "pageId": {
1379 "type": "string",
1380 "description": "The ID of the page to get.",
1381 "required": true,
1382 "location": "path"
1383 },
1384 "view": {
1385 "type": "string",
1386 "enum": [
1387 "ADMIN",
1388 "AUTHOR",
1389 "READER"
1390 ],
1391 "enumDescriptions": [
1392 "Admin level detail",
1393 "Author level detail",
1394 "Admin level detail"
1395 ],
1396 "location": "query"
1397 }
1398 },
1399 "parameterOrder": [
1400 "blogId",
1401 "pageId"
1402 ],
1403 "response": {
1404 "$ref": "Page"
1405 },
1406 "scopes": [
1407 "https://www.googleapis.com/auth/blogger",
1408 "https://www.googleapis.com/auth/blogger.readonly"
1409 ]
1410 },
1411 "insert": {
1412 "id": "blogger.pages.insert",
1413 "path": "blogs/{blogId}/pages",
1414 "httpMethod": "POST",
1415 "description": "Add a page.",
1416 "parameters": {
1417 "blogId": {
1418 "type": "string",
1419 "description": "ID of the blog to add the page to.",
1420 "required": true,
1421 "location": "path"
1422 }
1423 },
1424 "parameterOrder": [
1425 "blogId"
1426 ],
1427 "request": {
1428 "$ref": "Page"
1429 },
1430 "response": {
1431 "$ref": "Page"
1432 },
1433 "scopes": [
1434 "https://www.googleapis.com/auth/blogger"
1435 ]
1436 },
1437 "list": {
1438 "id": "blogger.pages.list",
1439 "path": "blogs/{blogId}/pages",
1440 "httpMethod": "GET",
1441 "description": "Retrieves the pages for a blog, optionally including non-LIVE statuses.",
1442 "parameters": {
1443 "blogId": {
1444 "type": "string",
1445 "description": "ID of the blog to fetch pages from.",
1446 "required": true,
1447 "location": "path"
1448 },
1449 "fetchBodies": {
1450 "type": "boolean",
1451 "description": "Whether to retrieve the Page bodies.",
1452 "location": "query"
1453 },
1454 "statuses": {
1455 "type": "string",
1456 "enum": [
1457 "draft",
1458 "imported",
1459 "live"
1460 ],
1461 "enumDescriptions": [
1462 "Draft (unpublished) Pages",
1463 "Pages that have had their content removed",
1464 "Pages that are publicly visible"
1465 ],
1466 "repeated": true,
1467 "location": "query"
1468 },
1469 "view": {
1470 "type": "string",
1471 "enum": [
1472 "ADMIN",
1473 "AUTHOR",
1474 "READER"
1475 ],
1476 "enumDescriptions": [
1477 "Admin level detail",
1478 "Author level detail",
1479 "Admin level detail"
1480 ],
1481 "location": "query"
1482 }
1483 },
1484 "parameterOrder": [
1485 "blogId"
1486 ],
1487 "response": {
1488 "$ref": "PageList"
1489 },
1490 "scopes": [
1491 "https://www.googleapis.com/auth/blogger",
1492 "https://www.googleapis.com/auth/blogger.readonly"
1493 ]
1494 },
1495 "patch": {
1496 "id": "blogger.pages.patch",
1497 "path": "blogs/{blogId}/pages/{pageId}",
1498 "httpMethod": "PATCH",
1499 "description": "Update a page. This method supports patch semantics.",
1500 "parameters": {
1501 "blogId": {
1502 "type": "string",
1503 "description": "The ID of the Blog.",
1504 "required": true,
1505 "location": "path"
1506 },
1507 "pageId": {
1508 "type": "string",
1509 "description": "The ID of the Page.",
1510 "required": true,
1511 "location": "path"
1512 }
1513 },
1514 "parameterOrder": [
1515 "blogId",
1516 "pageId"
1517 ],
1518 "request": {
1519 "$ref": "Page"
1520 },
1521 "response": {
1522 "$ref": "Page"
1523 },
1524 "scopes": [
1525 "https://www.googleapis.com/auth/blogger"
1526 ]
1527 },
1528 "update": {
1529 "id": "blogger.pages.update",
1530 "path": "blogs/{blogId}/pages/{pageId}",
1531 "httpMethod": "PUT",
1532 "description": "Update a page.",
1533 "parameters": {
1534 "blogId": {
1535 "type": "string",
1536 "description": "The ID of the Blog.",
1537 "required": true,
1538 "location": "path"
1539 },
1540 "pageId": {
1541 "type": "string",
1542 "description": "The ID of the Page.",
1543 "required": true,
1544 "location": "path"
1545 }
1546 },
1547 "parameterOrder": [
1548 "blogId",
1549 "pageId"
1550 ],
1551 "request": {
1552 "$ref": "Page"
1553 },
1554 "response": {
1555 "$ref": "Page"
1556 },
1557 "scopes": [
1558 "https://www.googleapis.com/auth/blogger"
1559 ]
1560 }
1561 }
1562 },
1563 "postUserInfos": {
1564 "methods": {
1565 "get": {
1566 "id": "blogger.postUserInfos.get",
1567 "path": "users/{userId}/blogs/{blogId}/posts/{postId}",
1568 "httpMethod": "GET",
1569 "description": "Gets one post and user info pair by postId and userId.",
1570 "parameters": {
1571 "blogId": {
1572 "type": "string",
1573 "description": "The ID of the blog.",
1574 "required": true,
1575 "location": "path"
1576 },
1577 "maxComments": {
1578 "type": "integer",
1579 "description": "Maximum number of comments to pull back on a post.",
1580 "format": "uint32",
1581 "location": "query"
1582 },
1583 "postId": {
1584 "type": "string",
1585 "description": "The ID of the post to get.",
1586 "required": true,
1587 "location": "path"
1588 },
1589 "userId": {
1590 "type": "string",
1591 "description": "ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.",
1592 "required": true,
1593 "location": "path"
1594 }
1595 },
1596 "parameterOrder": [
1597 "userId",
1598 "blogId",
1599 "postId"
1600 ],
1601 "response": {
1602 "$ref": "PostUserInfo"
1603 },
1604 "scopes": [
1605 "https://www.googleapis.com/auth/blogger",
1606 "https://www.googleapis.com/auth/blogger.readonly"
1607 ]
1608 },
1609 "list": {
1610 "id": "blogger.postUserInfos.list",
1611 "path": "users/{userId}/blogs/{blogId}/posts",
1612 "httpMethod": "GET",
1613 "description": "Retrieves a list of post and user info pairs, possibly filtered.",
1614 "parameters": {
1615 "blogId": {
1616 "type": "string",
1617 "description": "ID of the blog to fetch posts from.",
1618 "required": true,
1619 "location": "path"
1620 },
1621 "endDate": {
1622 "type": "string",
1623 "description": "Latest post date to fetch, a date-time with RFC 3339 formatting.",
1624 "format": "date-time",
1625 "location": "query"
1626 },
1627 "fetchBodies": {
1628 "type": "boolean",
1629 "description": "Whether the body content of posts is included.",
1630 "location": "query"
1631 },
1632 "labels": {
1633 "type": "string",
1634 "description": "Comma-separated list of labels to search for.",
1635 "location": "query"
1636 },
1637 "maxResults": {
1638 "type": "integer",
1639 "description": "Maximum number of posts to fetch.",
1640 "format": "uint32",
1641 "location": "query"
1642 },
1643 "orderBy": {
1644 "type": "string",
1645 "description": "Sort search results",
1646 "default": "PUBLISHED",
1647 "enum": [
1648 "published",
1649 "updated"
1650 ],
1651 "enumDescriptions": [
1652 "Order by the date the post was published",
1653 "Order by the date the post was last updated"
1654 ],
1655 "location": "query"
1656 },
1657 "pageToken": {
1658 "type": "string",
1659 "description": "Continuation token if the request is paged.",
1660 "location": "query"
1661 },
1662 "startDate": {
1663 "type": "string",
1664 "description": "Earliest post date to fetch, a date-time with RFC 3339 formatting.",
1665 "format": "date-time",
1666 "location": "query"
1667 },
1668 "statuses": {
1669 "type": "string",
1670 "enum": [
1671 "draft",
1672 "live",
1673 "scheduled"
1674 ],
1675 "enumDescriptions": [
1676 "Draft posts",
1677 "Published posts",
1678 "Posts that are scheduled to publish in future."
1679 ],
1680 "repeated": true,
1681 "location": "query"
1682 },
1683 "userId": {
1684 "type": "string",
1685 "description": "ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.",
1686 "required": true,
1687 "location": "path"
1688 },
1689 "view": {
1690 "type": "string",
1691 "enum": [
1692 "ADMIN",
1693 "AUTHOR",
1694 "READER"
1695 ],
1696 "enumDescriptions": [
1697 "Admin level detail",
1698 "Author level detail",
1699 "Reader level detail"
1700 ],
1701 "location": "query"
1702 }
1703 },
1704 "parameterOrder": [
1705 "userId",
1706 "blogId"
1707 ],
1708 "response": {
1709 "$ref": "PostUserInfosList"
1710 },
1711 "scopes": [
1712 "https://www.googleapis.com/auth/blogger",
1713 "https://www.googleapis.com/auth/blogger.readonly"
1714 ]
1715 }
1716 }
1717 },
1718 "posts": {
1719 "methods": {
1720 "delete": {
1721 "id": "blogger.posts.delete",
1722 "path": "blogs/{blogId}/posts/{postId}",
1723 "httpMethod": "DELETE",
1724 "description": "Delete a post by id.",
1725 "parameters": {
1726 "blogId": {
1727 "type": "string",
1728 "description": "The Id of the Blog.",
1729 "required": true,
1730 "location": "path"
1731 },
1732 "postId": {
1733 "type": "string",
1734 "description": "The ID of the Post.",
1735 "required": true,
1736 "location": "path"
1737 }
1738 },
1739 "parameterOrder": [
1740 "blogId",
1741 "postId"
1742 ],
1743 "scopes": [
1744 "https://www.googleapis.com/auth/blogger"
1745 ]
1746 },
1747 "get": {
1748 "id": "blogger.posts.get",
1749 "path": "blogs/{blogId}/posts/{postId}",
1750 "httpMethod": "GET",
1751 "description": "Get a post by id.",
1752 "parameters": {
1753 "blogId": {
1754 "type": "string",
1755 "description": "ID of the blog to fetch the post from.",
1756 "required": true,
1757 "location": "path"
1758 },
1759 "maxComments": {
1760 "type": "integer",
1761 "description": "Maximum number of comments to pull back on a post.",
1762 "format": "uint32",
1763 "location": "query"
1764 },
1765 "postId": {
1766 "type": "string",
1767 "description": "The ID of the post",
1768 "required": true,
1769 "location": "path"
1770 },
1771 "view": {
1772 "type": "string",
1773 "enum": [
1774 "ADMIN",
1775 "AUTHOR",
1776 "READER"
1777 ],
1778 "enumDescriptions": [
1779 "Admin level detail",
1780 "Author level detail",
1781 "Admin level detail"
1782 ],
1783 "location": "query"
1784 }
1785 },
1786 "parameterOrder": [
1787 "blogId",
1788 "postId"
1789 ],
1790 "response": {
1791 "$ref": "Post"
1792 },
1793 "scopes": [
1794 "https://www.googleapis.com/auth/blogger",
1795 "https://www.googleapis.com/auth/blogger.readonly"
1796 ]
1797 },
1798 "getByPath": {
1799 "id": "blogger.posts.getByPath",
1800 "path": "blogs/{blogId}/posts/bypath",
1801 "httpMethod": "GET",
1802 "description": "Retrieve a Post by Path.",
1803 "parameters": {
1804 "blogId": {
1805 "type": "string",
1806 "description": "ID of the blog to fetch the post from.",
1807 "required": true,
1808 "location": "path"
1809 },
1810 "maxComments": {
1811 "type": "integer",
1812 "description": "Maximum number of comments to pull back on a post.",
1813 "format": "uint32",
1814 "location": "query"
1815 },
1816 "path": {
1817 "type": "string",
1818 "description": "Path of the Post to retrieve.",
1819 "required": true,
1820 "location": "query"
1821 },
1822 "view": {
1823 "type": "string",
1824 "enum": [
1825 "ADMIN",
1826 "AUTHOR",
1827 "READER"
1828 ],
1829 "enumDescriptions": [
1830 "Admin level detail",
1831 "Author level detail",
1832 "Admin level detail"
1833 ],
1834 "location": "query"
1835 }
1836 },
1837 "parameterOrder": [
1838 "blogId",
1839 "path"
1840 ],
1841 "response": {
1842 "$ref": "Post"
1843 },
1844 "scopes": [
1845 "https://www.googleapis.com/auth/blogger",
1846 "https://www.googleapis.com/auth/blogger.readonly"
1847 ]
1848 },
1849 "insert": {
1850 "id": "blogger.posts.insert",
1851 "path": "blogs/{blogId}/posts",
1852 "httpMethod": "POST",
1853 "description": "Add a post.",
1854 "parameters": {
1855 "blogId": {
1856 "type": "string",
1857 "description": "ID of the blog to add the post to.",
1858 "required": true,
1859 "location": "path"
1860 },
1861 "isDraft": {
1862 "type": "boolean",
1863 "description": "Whether to create the post as a draft",
1864 "location": "query"
1865 }
1866 },
1867 "parameterOrder": [
1868 "blogId"
1869 ],
1870 "request": {
1871 "$ref": "Post"
1872 },
1873 "response": {
1874 "$ref": "Post"
1875 },
1876 "scopes": [
1877 "https://www.googleapis.com/auth/blogger"
1878 ]
1879 },
1880 "list": {
1881 "id": "blogger.posts.list",
1882 "path": "blogs/{blogId}/posts",
1883 "httpMethod": "GET",
1884 "description": "Retrieves a list of posts, possibly filtered.",
1885 "parameters": {
1886 "blogId": {
1887 "type": "string",
1888 "description": "ID of the blog to fetch posts from.",
1889 "required": true,
1890 "location": "path"
1891 },
1892 "endDate": {
1893 "type": "string",
1894 "description": "Latest post date to fetch, a date-time with RFC 3339 formatting.",
1895 "format": "date-time",
1896 "location": "query"
1897 },
1898 "fetchBodies": {
1899 "type": "boolean",
1900 "description": "Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.",
1901 "default": "true",
1902 "location": "query"
1903 },
1904 "fetchImages": {
1905 "type": "boolean",
1906 "description": "Whether image URL metadata for each post is included.",
1907 "location": "query"
1908 },
1909 "labels": {
1910 "type": "string",
1911 "description": "Comma-separated list of labels to search for.",
1912 "location": "query"
1913 },
1914 "maxResults": {
1915 "type": "integer",
1916 "description": "Maximum number of posts to fetch.",
1917 "format": "uint32",
1918 "location": "query"
1919 },
1920 "orderBy": {
1921 "type": "string",
1922 "description": "Sort search results",
1923 "default": "PUBLISHED",
1924 "enum": [
1925 "published",
1926 "updated"
1927 ],
1928 "enumDescriptions": [
1929 "Order by the date the post was published",
1930 "Order by the date the post was last updated"
1931 ],
1932 "location": "query"
1933 },
1934 "pageToken": {
1935 "type": "string",
1936 "description": "Continuation token if the request is paged.",
1937 "location": "query"
1938 },
1939 "startDate": {
1940 "type": "string",
1941 "description": "Earliest post date to fetch, a date-time with RFC 3339 formatting.",
1942 "format": "date-time",
1943 "location": "query"
1944 },
1945 "statuses": {
1946 "type": "string",
1947 "enum": [
1948 "draft",
1949 "live",
1950 "scheduled"
1951 ],
1952 "enumDescriptions": [
1953 "Draft posts",
1954 "Published posts",
1955 "Posts that are scheduled to publish in future."
1956 ],
1957 "repeated": true,
1958 "location": "query"
1959 },
1960 "view": {
1961 "type": "string",
1962 "enum": [
1963 "ADMIN",
1964 "AUTHOR",
1965 "READER"
1966 ],
1967 "enumDescriptions": [
1968 "Admin level detail",
1969 "Author level detail",
1970 "Reader level detail"
1971 ],
1972 "location": "query"
1973 }
1974 },
1975 "parameterOrder": [
1976 "blogId"
1977 ],
1978 "response": {
1979 "$ref": "PostList"
1980 },
1981 "scopes": [
1982 "https://www.googleapis.com/auth/blogger",
1983 "https://www.googleapis.com/auth/blogger.readonly"
1984 ]
1985 },
1986 "patch": {
1987 "id": "blogger.posts.patch",
1988 "path": "blogs/{blogId}/posts/{postId}",
1989 "httpMethod": "PATCH",
1990 "description": "Update a post. This method supports patch semantics.",
1991 "parameters": {
1992 "blogId": {
1993 "type": "string",
1994 "description": "The ID of the Blog.",
1995 "required": true,
1996 "location": "path"
1997 },
1998 "postId": {
1999 "type": "string",
2000 "description": "The ID of the Post.",
2001 "required": true,
2002 "location": "path"
2003 }
2004 },
2005 "parameterOrder": [
2006 "blogId",
2007 "postId"
2008 ],
2009 "request": {
2010 "$ref": "Post"
2011 },
2012 "response": {
2013 "$ref": "Post"
2014 },
2015 "scopes": [
2016 "https://www.googleapis.com/auth/blogger"
2017 ]
2018 },
2019 "publish": {
2020 "id": "blogger.posts.publish",
2021 "path": "blogs/{blogId}/posts/{postId}/publish",
2022 "httpMethod": "POST",
2023 "description": "Publish a draft post.",
2024 "parameters": {
2025 "blogId": {
2026 "type": "string",
2027 "description": "The ID of the Blog.",
2028 "required": true,
2029 "location": "path"
2030 },
2031 "postId": {
2032 "type": "string",
2033 "description": "The ID of the Post.",
2034 "required": true,
2035 "location": "path"
2036 },
2037 "publishDate": {
2038 "type": "string",
2039 "description": "The date and time to schedule the publishing of the Blog.",
2040 "format": "date-time",
2041 "location": "query"
2042 }
2043 },
2044 "parameterOrder": [
2045 "blogId",
2046 "postId"
2047 ],
2048 "response": {
2049 "$ref": "Post"
2050 },
2051 "scopes": [
2052 "https://www.googleapis.com/auth/blogger"
2053 ]
2054 },
2055 "revert": {
2056 "id": "blogger.posts.revert",
2057 "path": "blogs/{blogId}/posts/{postId}/revert",
2058 "httpMethod": "POST",
2059 "description": "Revert a published or scheduled post to draft state.",
2060 "parameters": {
2061 "blogId": {
2062 "type": "string",
2063 "description": "The ID of the Blog.",
2064 "required": true,
2065 "location": "path"
2066 },
2067 "postId": {
2068 "type": "string",
2069 "description": "The ID of the Post.",
2070 "required": true,
2071 "location": "path"
2072 }
2073 },
2074 "parameterOrder": [
2075 "blogId",
2076 "postId"
2077 ],
2078 "response": {
2079 "$ref": "Post"
2080 },
2081 "scopes": [
2082 "https://www.googleapis.com/auth/blogger"
2083 ]
2084 },
2085 "search": {
2086 "id": "blogger.posts.search",
2087 "path": "blogs/{blogId}/posts/search",
2088 "httpMethod": "GET",
2089 "description": "Search for a post.",
2090 "parameters": {
2091 "blogId": {
2092 "type": "string",
2093 "description": "ID of the blog to fetch the post from.",
2094 "required": true,
2095 "location": "path"
2096 },
2097 "fetchBodies": {
2098 "type": "boolean",
2099 "description": "Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.",
2100 "default": "true",
2101 "location": "query"
2102 },
2103 "orderBy": {
2104 "type": "string",
2105 "description": "Sort search results",
2106 "default": "PUBLISHED",
2107 "enum": [
2108 "published",
2109 "updated"
2110 ],
2111 "enumDescriptions": [
2112 "Order by the date the post was published",
2113 "Order by the date the post was last updated"
2114 ],
2115 "location": "query"
2116 },
2117 "q": {
2118 "type": "string",
2119 "description": "Query terms to search this blog for matching posts.",
2120 "required": true,
2121 "location": "query"
2122 }
2123 },
2124 "parameterOrder": [
2125 "blogId",
2126 "q"
2127 ],
2128 "response": {
2129 "$ref": "PostList"
2130 },
2131 "scopes": [
2132 "https://www.googleapis.com/auth/blogger",
2133 "https://www.googleapis.com/auth/blogger.readonly"
2134 ]
2135 },
2136 "update": {
2137 "id": "blogger.posts.update",
2138 "path": "blogs/{blogId}/posts/{postId}",
2139 "httpMethod": "PUT",
2140 "description": "Update a post.",
2141 "parameters": {
2142 "blogId": {
2143 "type": "string",
2144 "description": "The ID of the Blog.",
2145 "required": true,
2146 "location": "path"
2147 },
2148 "postId": {
2149 "type": "string",
2150 "description": "The ID of the Post.",
2151 "required": true,
2152 "location": "path"
2153 }
2154 },
2155 "parameterOrder": [
2156 "blogId",
2157 "postId"
2158 ],
2159 "request": {
2160 "$ref": "Post"
2161 },
2162 "response": {
2163 "$ref": "Post"
2164 },
2165 "scopes": [
2166 "https://www.googleapis.com/auth/blogger"
2167 ]
2168 }
2169 }
2170 },
2171 "users": {
2172 "methods": {
2173 "get": {
2174 "id": "blogger.users.get",
2175 "path": "users/{userId}",
2176 "httpMethod": "GET",
2177 "description": "Gets one user by id.",
2178 "parameters": {
2179 "userId": {
2180 "type": "string",
2181 "description": "The ID of the user to get.",
2182 "required": true,
2183 "location": "path"
2184 }
2185 },
2186 "parameterOrder": [
2187 "userId"
2188 ],
2189 "response": {
2190 "$ref": "User"
2191 },
2192 "scopes": [
2193 "https://www.googleapis.com/auth/blogger",
2194 "https://www.googleapis.com/auth/blogger.readonly"
2195 ]
2196 }
2197 }
2198 }
2199 }
2200}
View as plain text