Beiträge: Suche

Sucht nach einem Beitrag, der den angegebenen Suchbegriffen entspricht Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.

Eine Autorisierung ist erforderlich, wenn der Blog, nach dem gesucht wird, privat ist.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Erforderliche Parameter
blogId string Die ID des Blogs, in dem gesucht werden soll.
q string Suchbegriffe, nach denen gesucht werden soll
Optionale Parameter
fetchBodies boolean Ob der Textinhalt von Beiträgen enthalten ist Setzen Sie diesen Parameter auf „false“, wenn der Textinhalt des Posts nicht erforderlich ist, um den Traffic zu minimieren. (Standard: true)
orderBy string Die auf die Suchergebnisse angewendete Sortierreihenfolge.

Zulässige Werte sind:
  • "published": Sortierung nach Veröffentlichungsdatum
  • "updated": Nach dem Datum sortieren, an dem der Beitrag zuletzt aktualisiert wurde

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string Die Art dieser Entität. Immer blogger#postList
nextPageToken string Das Paginierungstoken zum Abrufen der nächsten Seite, falls vorhanden.
items[] list Die Liste der Posts für dieses Blog.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek

// 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());
	}
}

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.