Yayınların listesini getirir. Şimdi deneyin veya bir örneğe göz atın.
Gönderiler gizli bir blogda bulunuyorsa yetkilendirme gerekir. Yayınlar herkese açık bir blogda bulunuyorsa bu yöntem yetkisiz bir şekilde çağrılabilir.
İstek
HTTP isteği
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Parametreler
Parametre adı | Değer | Açıklama |
---|---|---|
Gerekli parametreler | ||
blogId |
string |
Yayınların alınacağı blogun kimliği. |
İsteğe bağlı parametreler | ||
endDate |
datetime |
Getirilecek en son yayın tarihi, RFC 3339 biçimlendirmesine sahip bir date-time .
|
fetchBodies |
boolean |
Yayınların gövde içeriğinin dahil edilip edilmediği (varsayılan: true). Trafiğin en aza indirilmesine yardımcı olmak için, post gövdeler gerekli olmadığında bu politika false (yanlış) değerine ayarlanmalıdır.
(Varsayılan: true )
|
fetchImages |
boolean |
Her yayın için resim URL'si meta verilerinin eklenip eklenmediği. |
labels |
string |
Aranacak etiketlerin virgülle ayrılmış listesi. |
maxResults |
unsigned integer |
Getirilecek maksimum yayın sayısı. |
orderBy |
string |
Sıralama düzeni sonuçlara uygulandı.
Kabul edilen değerler şunlardır:
|
sortOption |
string |
UNAVAILABLE NOW
Sıralama yönü sonuçlara uygulandı. Kabul edilen değerler şunlardır:
|
pageToken |
string |
İstek çağrıldıysa devam jetonu. |
startDate |
datetime |
Alınacak en erken yayın tarihi, RFC 3339 biçimlendirmesine sahip bir date-time .
|
status |
string |
Kabul edilen değerler şunlardır:
|
view |
string |
Kabul edilen değerler şunlardır:
|
İstek içeriği
Bu yöntemle istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{ "kind": "blogger#postList", "nextPageToken": string, "items": [ posts Resource ] }
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
kind |
string |
Tüzel kişinin türü. Her zaman blogger#postList . |
|
nextPageToken |
string |
Varsa sonraki sayfayı getirmek için kullanılan sayfalara ayırma jetonu. | |
items[] |
list |
Bu blogdaki yayınların listesi. |
Örnekler
Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).
Java
Java istemci kitaplığını kullanır.
// 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();
}
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.