Recherche un post qui correspond aux termes de requête indiqués. Essayer maintenant ou voir un exemple
Une autorisation est requise si le blog recherché est privé.
Demande
Requête HTTP :
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search
Paramètres
Nom du paramètre | Value | Description |
---|---|---|
Réglages obligatoires | ||
blogId |
string |
Identifiant du blog dans lequel effectuer la recherche. |
q |
string |
Termes de requête à rechercher. |
Paramètres facultatifs | ||
fetchBodies |
boolean |
Indique si le corps du message est inclus. Pour réduire le trafic, définissez ce paramètre sur "false" lorsque le contenu du corps du post n'est pas requis.
(Par défaut : true )
|
orderBy |
string |
Ordre de tri appliqué aux résultats de recherche.
Les valeurs autorisées sont les suivantes :
|
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{ "kind": "blogger#postList", "nextPageToken": string, "items": [ posts Resource ] }
Nom de propriété | Value | Description | Remarques |
---|---|---|---|
kind |
string |
Genre de cette entité. Toujours blogger#postList |
|
nextPageToken |
string |
Jeton de pagination permettant de récupérer la page suivante, le cas échéant. | |
items[] |
list |
Liste des articles de ce blog. |
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
Il utilise la bibliothèque cliente Java.
// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";
// 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-PostsSearch-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
Search postsSearchAction = blogger.posts().search(BUZZ_BLOG_ID);
postsSearchAction.setQ("threaded comments");
// Restrict the result content to just the data we need.
postsSearchAction.setFields("items(content,published,title,url)");
// This step sends the request to the server.
PostList posts = postsSearchAction.execute();
// Now we can navigate the response.
if (posts.getItems() != null && !posts.getItems().isEmpty()) {
for (Post post : posts.getItems()) {
System.out.println("Title: " + post.getTitle());
System.out.println("Published: " + post.getPublished());
System.out.println("URL: " + post.getUrl());
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.