API de Blogger: Uso de la API

La API de Blogger te permite integrar contenido de Blogger a tu aplicación mediante las API de REST. Antes de comenzar, debes configurar la autorización.

Introducción

Este documento está dirigido a desarrolladores que quieran escribir aplicaciones que puedan interactuar con la API de Blogger. Blogger es una herramienta para crear sitios web que permiten a los usuarios publicar sus pensamientos de forma continua.

Si no conoces los conceptos de Blogger, lee el artículo Cómo empezar antes de empezar a programar.

Cómo identificar solicitudes y autorizar solicitudes

Cada solicitud que tu aplicación envía a las API de Blogger debe identificar tu aplicación en Google. Hay dos formas de identificar tu aplicación: mediante un token OAuth 2.0 (con el que también se autoriza la solicitud) o mediante la clave de API de la aplicación. La siguiente es una explicación de cómo determinar cuáles de esas opciones puedes usar:

  • Si se requiere autorización para la solicitud (como una solicitud de datos privados de un individuo), se debe utilizar la aplicación a fin de proporcionar un token OAuth 2.0 con la solicitud. Con la aplicación, también se puede proporcionar la clave de API, pero no es necesario.
  • Si no se requiere autorización para la solicitud (como una solicitud de datos públicos), se debe utilizar la aplicación a fin de proporcionar la clave de API o un token de OAuth 2.0, o ambas opciones.

Acerca de los protocolos de autorización

Tu aplicación debe usar OAuth 2.0 para autorizar solicitudes. No se admiten otros protocolos de autorización. Si tu aplicación usa Acceder con Google, tú controlarás algunos aspectos de la autorización.

Solicitudes de autorización con OAuth 2.0

Las solicitudes a las API de Blogger para datos del usuario que no son públicos deben estar autorizadas por un usuario autenticado.

Este proceso se facilita con un ID de cliente de OAuth.

Obtén un ID de cliente de OAuth

También puedes crear una en la página Credenciales.

Los detalles del proceso de autorización, o "flujo", para OAuth 2.0 varían de alguna manera según el tipo de aplicación que estás escribiendo. El siguiente proceso general se aplica a todos los tipos de aplicación:

  1. Cuando la aplicación necesite acceder a datos del usuario, solicita a Google un alcance de acceso en particular.
  2. Google mostrará una pantalla de consentimiento al usuario, en la que le pedirá que permita a la aplicación solicitar algunos de sus datos.
  3. Si el usuario la aprueba, Google le otorgará a la aplicación un token de acceso de corta duración.
  4. La aplicación solicitará los datos del usuario y adjuntará el token de acceso a la solicitud.
  5. Si Google determina que la solicitud y el token son válidos, mostrará los datos solicitados.

Algunos flujos requieren pasos adicionales, como el uso de tokens de actualización, para adquirir nuevos tokens de acceso. Si deseas obtener información detallada sobre los flujos para varios tipos de aplicaciones, consulta la documentación de OAuth 2.0 de Google.

A continuación, se muestra información del alcance de OAuth 2.0 para las API de Blogger:

https://www.googleapis.com/auth/blogger

Para solicitar acceso con OAuth 2.0, tu aplicación necesita los datos del alcance, además de la información que Google proporciona cuando registras la aplicación (como el ID y el secreto del cliente).

Sugerencia: Las bibliotecas cliente de las API de Google pueden controlar algunos de los procesos de autorización por ti. Estas están disponibles para una variedad de lenguajes de programación. Si deseas obtener más información, consulta la página que incluye bibliotecas y ejemplos.

Adquiere y usa una clave de API

Las solicitudes a las API de Blogger para datos públicos deben ir acompañadas de un identificador, que puede ser una clave de API o un token de acceso.

Obtén una clave

También puedes crear una en la página Credenciales.

Una vez que tienes una clave de API, puedes usar tu aplicación para adjuntar el parámetro de consulta key=yourAPIKey a todas las URL de solicitud.

La clave de API en las URL se incorpora de manera segura, por lo que no necesita codificación.

Cómo trabajar con blogs

Cómo recuperar un blog

Puedes recuperar información para un blog en particular si envías una solicitud GET HTTP al URI del blog. El URI de un blog tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY

No es necesario autenticar a un usuario para que recupere un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y los datos del blog:

{
  "kind": "blogger#blog",
  "id": "2399953",
  "name": "Blogger Buzz",
  "description": "The Official Buzz from Blogger at Google",
  "published": "2007-04-23T22:17:29.261Z",
  "updated": "2011-08-02T06:01:15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

Cómo recuperar un blog por su URL

Puedes recuperar un blog con su URL si envías una solicitud HTTP GET al siguiente URI con un parámetro url:

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

Solicitud

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

Respuesta

Si la solicitud se completa de forma correcta, el servidor responde con un código de estado HTTP 200 OK y la representación completa del blog identificado:

{
 "kind": "blogger#blog",
 "id": "3213900",
 "name": "Blogger Developers Network",
 "description": "The official Blogger Developers Network weblog.",
 "published": "2007-02-09T10:13:10-08:00",
 "updated": "2012-04-15T19:38:01-07:00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900",
 "posts": {
  "totalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts"
 },
 "pages": {
  "totalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages"
 },
 "locale": {
  "language": "en",
  "country": "US",
  "variant": ""
 }
}

Recuperación de blogs de un usuario

Para recuperar una lista de los blogs de un usuario, envía una solicitud HTTP GET al URI de colección de blogs:

https://www.googleapis.com/blogger/v3/users/userId/blogs

Solicitud

GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */

Nota: El usuario debe autenticarse para mostrar sus propios blogs, por lo que debes proporcionar el encabezado HTTP Authorization con la solicitud GET.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK y la representación completa de la lista de blogs del usuario:

{
  "kind": "blogger#blogList",
  "items": [
    {
      "kind": "blogger#blog",
      "id": "4967929378133675647",
      "name": "Brett's Test Blawg",
      "description": "",
      "published": "2010-10-06T23:33:31.662Z",
      "updated": "2011-08-08T06:50:02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

Cómo trabajar con publicaciones

Cómo recuperar entradas de un blog

Puedes recuperar una lista de entradas de un blog determinado si envías una solicitud GET al URI de colección de entradas. El URI para una colección de publicaciones tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Solicitud

A continuación, se muestra un ejemplo:

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY

No es necesario autenticar a un usuario para que recupere un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK y la lista de publicaciones:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "items": [
    {
      "kind": "blogger#post",
      "id": "7706273476706534553",
      "blog": {
        "id": "2399953"
      },
      "published": "2011-08-01T19:58:00.000Z",
      "updated": "2011-08-01T19:58:51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
      "title": "Latest updates, August 1st",
      "content": "elided for readability",
      "author": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "image": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "replies": {
        "totalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

Cómo recuperar una publicación específica

Puedes recuperar una entrada específica de un blog si envías una solicitud GET al URI del recurso de entradas. El URI de un recurso de publicaciones tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY

No es necesario autenticar a un usuario para que recupere un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Buscando una publicación

Puedes buscar entradas de un blog si envías una solicitud GET al URI de búsqueda de entradas con el parámetro de búsqueda q:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

No es necesario autenticar a un usuario para que recupere un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "items": [
  {
    "kind": "blogger#post",
    "id": "1387873546480002228",
    "blog": {
      "id": "3213900"
    },
    "published": "2012-03-23T01:58:00-07:00",
    "updated": "2012-03-23T01:58:12-07:00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228",
    "title": "Blogger Documentation has moved to developers.google.com",
    "content": "content elided for readability",
    "author": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "image": {
        "url": "https://resources.blogblog.com/img/b16-rounded.gif"
      }
    },
    "replies": {
      "totalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

Cómo agregar una publicación

Puedes agregar una entrada para un blog enviando una solicitud POST al URI de colección de entradas con un cuerpo de JSON de entrada:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/

Solicitud

POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
  "kind": "blogger#post",
  "blog": {
    "id": "8070105920543249955"
  },
  "title": "A new post",
  "content": "With <b>exciting</b> content..."
}

Debes autenticarte para crear una publicación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "A new post",
 "content": "With <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Cómo eliminar una publicación

Puedes borrar una entrada para un blog si envías una solicitud DELETE al URI del recurso de la entrada:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Solicitud

A continuación, se muestra un ejemplo:

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

Debes estar autenticado para eliminar una publicación.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK.

Cómo recuperar una publicación por su ruta

Puedes recuperar una entrada de un blog si envías una solicitud GET al URI de las rutas de acceso de entradas con un parámetro path. El URI para una solicitud de publicaciones por ruta de acceso tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

Solicitud

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

No es necesario autenticar a un usuario para que recupere un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Actualizando una publicación

Puedes actualizar una entrada para un blog mediante el envío de una solicitud PUT al URI del recurso de la entrada con un cuerpo de entrada JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Solicitud

PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "kind": "blogger#post",
 "id": "3445355871727114160",
 "blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content..."
}

Debes autenticarte para actualizar una publicación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Cómo actualizar una publicación con semántica de parches

Puedes actualizar una publicación con la semántica de parches mediante el envío de una solicitud PATCH al URI de recurso de la entrada con un cuerpo de publicación JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Solicitud

A continuación, se muestra un ejemplo:

PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "content": "With absolutely <b>fabulous</b> content..."
}

Debes autenticarte para actualizar una publicación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y el contenido de la publicación:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With absolutely <b>fabulous</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Cómo trabajar con comentarios

Cómo recuperar los comentarios de una publicación

Puedes recuperar una lista de comentarios para una publicación si envías una solicitud GET al URI de colección de comentarios. El URI para una colección de comentarios tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY

&no es necesario autenticar al usuario para recuperar un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK y la lista de comentarios:

{
  "kind": "blogger#commentList",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "items": [
    {
       "kind": "blogger#comment",
       "id": "9200761938824362519",
       "post": {
         "id": "6069922188027612413"
       },
       "blog": {
         "id": "2399953"
       },
       "published": "2011-07-28T19:19:57.740Z",
       "updated": "2011-07-28T21:29:42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "content": "elided",
       "author": {
         "id": "530579030283",
         "displayName": "elided",
         "url": "elided",
         "image": {
           "url": "elided"
         }
       }
    },
    {
      "kind": "blogger#comment",
      "id": "400101178920857170",
      elided for readability
    }
  ]
}

Cómo recuperar un comentario específico

Puedes recuperar un comentario específico de una publicación si envías una solicitud GET al URI del recurso de los comentarios. El URI de un recurso de comentarios tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY

&no es necesario autenticar al usuario para recuperar un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK y los datos del comentario:

{
  "kind": "blogger#comment",
  "id": "9200761938824362519",
  "post": {
    "id": "6069922188027612413"
  },
  "blog": {
    "id": "2399953"
  },
  "published": "2011-07-28T19:19:57.740Z",
  "updated": "2011-07-28T21:29:42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

Cómo trabajar con páginas

Cómo recuperar páginas para un blog

Puedes recuperar una lista de páginas de un blog si envías una solicitud GET al URI de colección de páginas. El URI de una colección de páginas tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY

&no es necesario autenticar al usuario para recuperar un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se completa de forma correcta, el servidor responde con un código de estado HTTP 200 OK y la lista de páginas:

{
  "kind": "blogger#pageList",
  "items": [
    {
      "kind": "blogger#page",
      "id": "273541696466681878",
      "blog": {
        "id": "4967929378133675647"
      },
      "published": "2011-07-14T16:16:00.000Z",
      "updated": "2011-07-14T16:16:23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
      "title": "Static Content",
      "content": "elided for readability",
      "author": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "image": {
          "url": "https://resources.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

Cómo recuperar una página específica

Puedes recuperar una página específica de un blog si envías una solicitud GET al URI del recurso de la página. El URI de un recurso de páginas tiene el siguiente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId

Solicitud

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY

&no es necesario autenticar al usuario para recuperar un blog público. La aplicación no necesita incluir un encabezado HTTP Authorization para una solicitud de blog pública; sin embargo, debes proporcionar la clave de API.

Blogger también tiene blogs privados que requieren autenticación.

Respuesta

Si la solicitud se realiza correctamente, el servidor responde con un código de estado HTTP 200 OK y los datos de la página:

{
  "kind": "blogger#page",
  "id": "273541696466681878",
  "blog": {
    "id": "4967929378133675647"
  },
  "published": "2011-07-14T16:16:00.000Z",
  "updated": "2011-07-14T16:16:23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
  "title": "Static Content",
  "content": "elided for readability",
  "author": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "image": {
      "url": "https://resources.blogblog.com/img/b16-rounded.gif"
    }
  }
}

Trabajar con usuarios

Recupera un usuario

Para recuperar la información de un usuario, envía una solicitud GET HTTP al URI del recurso del usuario:

https://www.googleapis.com/blogger/v3/users/userId

Solicitud

GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */

Nota: El usuario debe estar autenticado para mostrar su propia información, por lo que debes proporcionar el encabezado HTTP Authorization con la solicitud GET.

Respuesta

Si la solicitud se realiza de forma correcta, el servidor responde con un código de estado HTTP 200 OK y un vínculo a una lista de los blogs del usuario:

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs"
  }
}

Parámetros de búsqueda estándar

Los siguientes parámetros de consulta se pueden usar con todos los métodos y recursos en las API de Blogger.

Los parámetros de búsqueda que se aplican a todas las operaciones de las API de Blogger se documentan en Parámetros del sistema.