Post: ricerca

Cerca un post che corrisponda ai termini di query specificati. Prova subito o guarda un esempio.

Se il blog in cui viene eseguita la ricerca è privato, sarà necessaria l'autorizzazione.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri obbligatori
blogId string L'ID del blog in cui eseguire la ricerca.
q string Termini di query da cercare.
Parametri facoltativi
fetchBodies boolean Se sono inclusi i contenuti del corpo dei post. Per ridurre al minimo il traffico, imposta questo parametro su false quando i contenuti del corpo del post non sono richiesti. (Valore predefinito: true)
orderBy string L'ordinamento applicato ai risultati di ricerca.

I valori accettati sono:
  • "published": ordina in base alla data di pubblicazione del post
  • "updated": ordina in base alla data dell'ultimo aggiornamento del post

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nome proprietà Valore Descrizione Note
kind string Il tipo di questa entità. Sempre blogger#postList
nextPageToken string Token di impaginazione per recuperare la pagina successiva, se esistente.
items[] list L'elenco dei post per questo blog.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client 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());
	}
}

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.