API de Blogger: Cómo usar la API

La API de Blogger te permite integrar contenido de Blogger en tu aplicación mediante las APIs de REST. Antes de comenzar, deberás configurar la autorización.

Introducción

Este documento está dirigido a desarrolladores que deseen crear aplicaciones que puedan interactuar con la API de Blogger. Blogger es una herramienta para crear sitios web que permiten a las personas publicar sus ideas de forma continua.

Si no conoces los conceptos de Blogger, te recomendamos leer el artículo Cómo comenzar antes de comenzar a programar.

Autoriza solicitudes e identifica tu aplicación

Cada solicitud que tu aplicación envía a las APIs de Blogger debe identificar tu aplicación ante 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 APIs de Blogger para datos de usuario no públicos deben contar con la autorización de 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, encontrarás información del alcance de OAuth 2.0 para las APIs 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 de datos públicos a las APIs de Blogger 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

Para recuperar información de un blog en particular, envía 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 que un usuario se autentique para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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

Para recuperar un blog mediante su URL, envía una solicitud GET HTTP 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 realiza correctamente, 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": ""
 }
}

Cómo recuperar los blogs de un usuario

Para recuperar una lista de los blogs de un usuario, envía una solicitud HTTP GET al URI de la 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: Se debe autenticar al usuario para que enumere sus propios blogs, por lo que debes proporcionar el encabezado HTTP Authorization con la solicitud GET.

Respuesta

Si la solicitud se realiza correctamente, 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": ""
      }
    }
  ]
}

Trabajo con publicaciones

Cómo recuperar publicaciones de un blog

Para recuperar una lista de entradas de un blog determinado, envía una solicitud GET al URI de la colección de entradas. El URI de 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 que un usuario se autentique para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 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

Para recuperar una entrada específica de un blog, envía 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 que un usuario se autentique para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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

Para buscar entradas de un blog, envía 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 que un usuario se autentique para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 de un blog si envías una solicitud POST al URI de la colección de entradas con un cuerpo 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 estar autenticado 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 borrar una publicación

Para borrar una entrada de un blog, envía una solicitud DELETE al URI del recurso de 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 borrar una publicación.

Respuesta

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

Cómo recuperar una publicación por su ruta de acceso

Para recuperar una entrada de un blog, envía una solicitud GET al URI por ruta de acceso de entradas con un parámetro path. El URI para una solicitud de publicación 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 que un usuario se autentique para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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"
  }
}

Cómo actualizar una publicación

Puedes actualizar una entrada de un blog si envías una solicitud PUT al URI del recurso de entrada con un cuerpo JSON de entrada:

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 estar autenticado 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 la semántica de parches

Puedes actualizar una publicación con la semántica de parche si envías una solicitud PATCH al URI del recurso de publicación con un cuerpo JSON de publicación:

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 estar autenticado 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"
 }
}

Trabajo con comentarios

Cómo recuperar los comentarios de una publicación

Para recuperar una lista de comentarios de una publicación, envía una solicitud GET al URI de la colección de comentarios. El URI de 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

“Un usuario no necesita ser autenticado para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 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

Para recuperar un comentario específico de una publicación, envía una solicitud GET al URI del recurso de 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

“Un usuario no necesita ser autenticado para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 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 de un blog

Para recuperar una lista de páginas de un blog, envía una solicitud GET al URI de la 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

“Un usuario no necesita ser autenticado para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 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"
        }
      }
    }
  ]
}

Recupera una página específica

Para recuperar una página específica de un blog, envía una solicitud GET al URI de recurso de las páginas. 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

“Un usuario no necesita ser autenticado para recuperar un blog público. La aplicación no necesita incluir el encabezado HTTP Authorization para una solicitud de blog público; 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 de los usuarios:

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: Se debe autenticar al usuario para que incluya su propia información, por lo que debes proporcionar el encabezado HTTP Authorization con la solicitud GET.

Respuesta

Si la solicitud se realiza correctamente, 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 búsqueda se pueden usar con todos los métodos y recursos de las APIs de Blogger.

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