پست ها: لیست

لیستی از پست ها را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

اگر پست‌ها در وبلاگی خصوصی هستند، مجوز لازم است. اگر پست ها در وبلاگی هستند که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.

درخواست کنید

درخواست HTTP 

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

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مورد نیاز
blogId string شناسه وبلاگ برای دریافت پست ها از آن.
پارامترهای اختیاری
endDate datetime آخرین تاریخ ارسال برای واکشی، date-time با قالب بندی RFC 3339 .
fetchBodies boolean آیا محتوای بدنه پست‌ها گنجانده شده است (پیش‌فرض: درست). برای کمک به به حداقل رساندن ترافیک، زمانی که بدنه پست مورد نیاز نیست، باید روی false تنظیم شود. (پیش‌فرض: true )
fetchImages boolean آیا فراداده URL تصویر برای هر پست گنجانده شده است یا خیر.
labels string فهرستی از برچسب‌های جدا شده با کاما برای جستجو.
maxResults unsigned integer حداکثر تعداد پست برای واکشی
orderBy string ترتیب مرتب سازی به نتایج اعمال می شود.

مقادیر قابل قبول عبارتند از:
  • " published ": ترتیب بر اساس تاریخ انتشار پست
  • " updated ": بر اساس تاریخ آخرین به روز رسانی پست سفارش دهید
sortOption string UNAVAILABLE NOW

مرتب سازی جهت اعمال شده به نتایج.

مقادیر قابل قبول عبارتند از:
  • " descending ": مرتب سازی پست ها به ترتیب نزولی در زمان (پیش فرض)
  • " ascending ": مرتب سازی پست ها به ترتیب صعودی در زمان
pageToken string در صورتی که درخواست صفحه شده باشد، نشانه ادامه.
startDate datetime اولین تاریخ ارسال برای واکشی، date-time با قالب بندی RFC 3339 .
status string

مقادیر قابل قبول عبارتند از:
  • " draft ": پیش نویس پست ها
  • " live ": پست های منتشر شده
  • " scheduled ": پست هایی که قرار است در آینده منتشر شوند.
view string

مقادیر قابل قبول عبارتند از:
  • " ADMIN ": جزئیات سطح مدیریت
  • " AUTHOR ": جزئیات سطح نویسنده
  • " READER ": جزئیات سطح خواننده

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند: 

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  &quo}t;items": [
    posts Resource
  ]
نام ملک ارزش توضیحات یادداشت ها
kind string نوع این موجودیت. همیشه blogger#postList .
nextPageToken string نشانه صفحه‌بندی برای واکشی صفحه بعدی، در صورت وجود.
items[] list لیست پست های این وبلاگ

نمونه ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه کلاینت جاوا استفاده می کند

// The BlogId for the Blogger Buzz blog
String BUZZ_BLOG_ID = "23999
53";
// Configure the Java API Client for Installed 
Native AppHttpTransport HTTP_TRANSPORT = new NetHttpTr
ansport();JsonFactory JSON_FACTORY = new Jackson
Factory();
// Configure the Installed App OA
uth2 flow.Credential credential = OAuth2Native.authorize(HTTP_
TRANSPORT,	JSON_FACTORY, new LocalServerR
eceiver(),	Arrays.asList(BloggerScopes.
BLOGGER));
// Construct the Blogger API access faca
de object.Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSO
N_FACTORY)	.setApplicationName("Blogger-PostsLis
t-Snippet/1.0")	.setHttpRequestInitializer(
credential).build();
//
 The request action.List postsListAction = blogger.posts()
.list(BUZZ_BLOG_ID);
// Restrict the result content to ju
st the data we need.postsListAction.setFields("items(author/displayName,content,published,ti
tle,url),nextPageToken");
// This step se
nds the request to the server.PostList post
s = postsListAction.execute();
// Now
 we can navigate t
he response.int po
stCount = 0;int pageCount = 0;wh&&ile (posts.getItems() != null {
 !posts.getItems().isEmpty()) 	for ({
Post post : posts.getItems()) 		System.out.p
rintln("Post #"+ ++postCount);		System.o
ut.println("\tTitle: "+post.getTitle());		System.out.printl
n("\tAuthor: "+post.getAuthor().getDisplayName()
);		System.out.println("\tPublished: &quo
t;+post.getPublished());		System.out.println("\tU
R}
L: "+post.getUrl
());		System.out.println("\tContent: &qu
ot;+post.getContent());	
	// Paginatio>n log{
ic	Strin
g}
 pageToken = posts.getNextPageToken();	if (pa
geToken == null || ++pageCount = 5) 		bre
ak;		System.out.println("-- Ne
}xt page of posts");	postsListAction.setPageToken(pageToken);	posts = postsListAction.execute();

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.