You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

2200 lines
55 KiB

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