Beiträge: Suche

Sucht nach einem Beitrag, der den angegebenen Suchbegriffen entspricht Jetzt testen oder Beispiel ansehen

Eine Autorisierung ist erforderlich, wenn der Blog, in 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	Gibt an, ob der Text einer Nachricht enthalten ist. Um diesen Traffic zu minimieren, setzen Sie diesen Parameter auf „false“, wenn der Textkörper des Posts nicht erforderlich ist. (Standard: true)
orderBy	string	Die Sortierreihenfolge für die Suchergebnisse. Folgende Werte sind zulässig: „published“: Reihenfolge, in der der Beitrag veröffentlicht wurde „updated“: Sortieren nach dem Datum der letzten Aktualisierung des Beitrags

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, sofern vorhanden.
items[]	list	Die Liste der Posts für diesen 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());
	}
}

Testen!

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