Post: ricerca

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

Se il blog in cui si esegue la ricerca è privato, viene richiesta l'autorizzazione.

Risorse richieste:

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 ricerca da cercare.
Parametri facoltativi
fetchBodies boolean Indica se il contenuto del corpo dei post è incluso. Per ridurre al minimo il traffico, imposta questo parametro su false quando il contenuto del post del post non è obbligatorio. (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 di 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 di 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.

Utilizza l'Explorer API di seguito per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.