Ruft eine Liste von Beiträgen ab. Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.
Eine Autorisierung ist erforderlich, wenn die Posts auf einem privaten Blog veröffentlicht wurden. Wenn sich die Posts in einem öffentlichen Blog befinden, kann diese Methode ohne Autorisierung aufgerufen werden.
Anfrage
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 Posts abgerufen werden sollen. |
Optionale Parameter | ||
endDate |
datetime |
Letztes abzurufendes Post-Datum, ein date-time mit der Formatierung RFC 3339.
|
fetchBodies |
boolean |
Gibt an, ob der Textinhalt von Beiträgen enthalten ist (Standardeinstellung: true). Dieser Wert sollte auf "false" gesetzt werden, wenn die Beitragstexte nicht erforderlich sind, um den Datenverkehr zu minimieren.
(Standardeinstellung: true )
|
fetchImages |
boolean |
Gibt an, ob für jeden Beitrag Bild-URL-Metadaten enthalten sind. |
labels |
string |
Durch Kommas getrennte Liste der zu suchenden Labels. |
maxResults |
unsigned integer |
Maximale Anzahl der abzurufenden Posts. |
orderBy |
string |
Die Sortierreihenfolge wird auf die Ergebnisse angewendet.
Zulässige Werte sind:
|
sortOption |
string |
UNAVAILABLE NOW
Sortierrichtung auf die Ergebnisse angewendet. Zulässige Werte sind:
|
pageToken |
string |
Fortsetzungs-Token für den Fall, dass die Anfrage weitergeleitet wird. |
startDate |
datetime |
Frühestes Abrufdatum: ein date-time mit der Formatierung RFC 3339.
|
status |
string |
Zulässige Werte sind:
|
view |
string |
Zulässige Werte sind:
|
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 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.