Posts: Liste

Ruft eine Liste von Beiträgen ab. Jetzt testen oder Beispiel ansehen

Eine Autorisierung ist erforderlich, wenn sich die Beiträge in einem privaten Blog befinden. Wenn sich die Posts in einem öffentlichen Blog befinden, kann diese Methode ohne Autorisierung aufgerufen werden.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Erforderliche Parameter
blogId string Die ID des Blogs, von dem Beiträge abgerufen werden sollen.
Optionale Parameter
endDate datetime Spätester Veröffentlichungsdatum des Posts, date-time mit RFC 3339.
fetchBodies boolean Gibt an, ob der Text der Posts enthalten ist (Standardeinstellung: true). Sollte der Textkörper nicht erforderlich sein, sollte er auf „false“ gesetzt werden, um den Traffic zu minimieren. (Standard: true)
fetchImages boolean Gibt an, ob die Metadaten der Bild-URLs für die einzelnen Beiträge enthalten sind.
labels string Durch Kommas getrennte Liste der Labels, nach denen gesucht werden soll.
maxResults unsigned integer Maximale Anzahl der abzurufenden Beiträge.
orderBy string Sortierreihenfolge für Ergebnisse.

Folgende Werte sind zulässig:
  • „published“: Reihenfolge, in der der Beitrag veröffentlicht wurde
  • „updated“: Sortieren nach dem Datum der letzten Aktualisierung des Beitrags
sortOption string UNAVAILABLE NOW

Sortierrichtung auf Ergebnisse angewendet.

Folgende Werte sind zulässig:
  • "descending": Beiträge in absteigender Reihenfolge sortieren (Standard)
  • „ascending“: Beiträge in aufsteigender Reihenfolge sortieren
pageToken string Fortsetzungs-Token, wenn die Seite über die Anfrage gesendet wurde.
startDate datetime Frühestes Datum für das Abrufen, ein date-time im Format RFC 3339
status string

Folgende Werte sind zulässig:
  • "draft": Beitragsentwürfe
  • „live“: Veröffentlichte Beiträge
  • „scheduled“: Beiträge, deren Veröffentlichung in Zukunft geplant ist.
view string

Folgende Werte sind zulässig:
  • „ADMIN“: Details auf Administratorebene
  • „AUTHOR“: Details auf Autorenebene
  • „READER“: Leserdetails

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 Blogger Buzz 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-PostsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");

// This step sends the request to the server.
PostList posts = postsListAction.execute();

// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Post #"+ ++postCount);
		System.out.println("\tTitle: "+post.getTitle());
		System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
		System.out.println("\tPublished: "+post.getPublished());
		System.out.println("\tURL: "+post.getUrl());
		System.out.println("\tContent: "+post.getContent());
	}

	// Pagination logic
	String pageToken = posts.getNextPageToken();
	if (pageToken == null || ++pageCount >= 5) {
		break;
	}
	System.out.println("-- Next page of posts");
	postsListAction.setPageToken(pageToken);
	posts = postsListAction.execute();
}

Testen!

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