Ruft eine Liste von Beiträgen ab. Jetzt ausprobieren oder Beispiel ansehen
Autorisierung ist erforderlich, wenn die Beiträge in einem privaten Blog veröffentlicht werden. Wenn sich die Beiträge 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, aus dem Beiträge abgerufen werden sollen. |
| Optionale Parameter | ||
endDate |
datetime |
Das Datum des letzten abzurufenden Beitrags, ein date-time mit RFC 3339-Formatierung.
|
fetchBodies |
boolean |
Gibt an, ob der Inhalt von Beiträgen enthalten ist (Standard: „true“). Dieser Wert sollte auf „false“ gesetzt werden, wenn die Post-Bodys nicht erforderlich sind, um den Traffic zu minimieren.
(Standardeinstellung: true)
|
fetchImages |
boolean |
Gibt an, ob Metadaten für Bild-URLs für jeden Beitrag 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 |
Auf die Ergebnisse angewendete Sortierreihenfolge.
Zulässige Werte sind:
|
sortOption |
string |
UNAVAILABLE NOW
Sortierrichtung, die auf die Ergebnisse angewendet wird. Zulässige Werte sind:
|
pageToken |
string |
Fortsetzungs-Token, wenn die Anfrage paginiert ist. |
startDate |
datetime |
Das früheste Datum, an dem Beiträge abgerufen werden sollen, als date-time im RFC 3339-Format.
|
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 |
Der Typ dieser Entität. Immer blogger#postList. |
|
nextPageToken |
string |
Paginierungstoken zum Abrufen der nächsten Seite, falls vorhanden. | |
items[] |
list |
Die Liste der Beiträge 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.