Yayınlar: liste

Gönderi listesini alır. Hemen deneyin veya bir örneği inceleyin.

Yayınlar gizli olan bir blogda yer alıyorsa yetkilendirme gereklidir. Gönderiler herkese açık bir blogda ise bu yöntem izin alınmadan ç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 RFC 3339 biçimine sahip bir date-time, getirilecek en son yayınlanma tarihi.
fetchBodies boolean Yayınların gövde içeriğinin dahil edilip edilmediği (varsayılan: true). Trafiği en aza indirmek amacıyla gövde sonrası gerekli olmadığında bu değer false olarak ayarlanmalıdır. (Varsayılan: true)
fetchImages boolean Her yayına ait resim URL'si meta verilerinin dahil edilip edilmediği.
labels string Aranacak etiketlerin virgülle ayrılmış listesi.
maxResults unsigned integer Getirilecek maksimum yayın sayısı.
orderBy string Sıralama ölçütü sonuçlara uygulandı.

Kabul edilen değerler şunlardır:
  • "published": Yayının yayınlandığı tarihe göre sıralama
  • "updated": Yayının son güncellendiği tarihe göre sıralama
sortOption string UNAVAILABLE NOW

Sonuçlara sıralama yönü uygulandı.

Kabul edilen değerler şunlardır:
  • "descending": Yayınları zamana göre azalan düzende sıralayın (varsayılan)
  • "ascending": Yayınları artan düzende sıralayın
pageToken string İstek ayrılmışsa devam jetonu.
startDate datetime RFC 3339 biçimlendirmesine sahip date-time getirilecek en erken yayın tarihi.
status string

Kabul edilen değerler şunlardır:
  • "draft": Taslak yayınlar
  • "live": Yayınlanan yayınlar
  • "scheduled": Gelecekte yayınlanması planlanan yayınlar.
view string

Kabul edilen değerler şunlardır:
  • "ADMIN": Yönetici düzeyinde ayrıntı
  • "AUTHOR": Yazar düzeyinde ayrıntılar
  • "READER": Okuyucu seviyesi ayrıntıları

İstek metni

Bu yöntemi içeren bir 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 Bu öğenin türü. Her zaman blogger#postList.
nextPageToken string Sonraki sayfayı (varsa) getirmek için sayfalara ayırma jetonu.
items[] list Bu blogla ilgili 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.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.