Posts: getByPath

Récupère un article par chemin d'accès. Essayez dès maintenant ou consultez un exemple.

Une autorisation est requise si l'article est publié sur un blog privé.

Le chemin d'accès à un article est la partie de l'URL de l'article située après l'hôte. Par exemple, un article de blog dont l'URL est http://code.blogger.com/2011/09/blogger-json-api-now-available.html a le chemin /2011/09/blogger-json-api-now-available.html.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre Valeur Description
Paramètres obligatoires
blogId string ID du blog à partir duquel l'article doit être récupéré.
path string Chemin du post à récupérer.
Paramètres facultatifs
maxComments unsigned integer Nombre maximal de commentaires à récupérer pour un post. Si ce paramètre n'est pas spécifié, aucun commentaire n'est renvoyé pour la ressource "post".
view string

Les valeurs possibles sont les suivantes:
  • "ADMIN" : détails au niveau de l'administrateur
  • "AUTHOR" : détails au niveau de l'auteur
  • "READER" : détails au niveau de l'administrateur

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Posts" dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Elle utilise la bibliothèque cliente Java.

// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";

// The URL path component for a buzz post.
String BUZZ_POST_PATH = "/2012/01/engage-with-your-readers-through.html";

// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();

// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
	JSON_FACTORY, new LocalServerReceiver(),
	Arrays.asList(BloggerScopes.BLOGGER));

// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
	.setApplicationName("Blogger-PostsGetByPath-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
GetByPath postsGetByPathAction = blogger.posts().getByPath(BUZZ_BLOG_ID);
postsGetByPathAction.setPath(BUZZ_POST_PATH);

// Restrict the result content to just the data we need.
postsGetByPathAction.setFields("content,published,title");

// This step sends the request to the server.
Post post = postsGetByPathAction.execute();

// Now we can navigate the response.
System.out.println("Title: " + post.getTitle());
System.out.println("Published: " + post.getPublished());
System.out.println("Content: " + post.getContent());

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.