لیست صفحات یک وبلاگ را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
اگر صفحات در وبلاگی خصوصی هستند، مجوز لازم است. اگر صفحات در وبلاگی هستند که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.
درخواست
درخواست HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/pages
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مورد نیاز | ||
blogId | string | شناسه وبلاگ برای واکشی صفحات از. |
پارامترهای اختیاری | ||
fetchBodies | boolean | آیا برای بازیابی بدنه های صفحه. |
status | string | مقادیر قابل قبول عبارتند از:
|
view | string | مقادیر قابل قبول عبارتند از:
|
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "kind": "blogger#pageList", "items": [ pages Resource ] }
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
kind | string | نوع این موجودیت. همیشه blogger#pageList | |
items[] | list | فهرست منابع صفحات برای وبلاگ مشخص شده. |
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه کلاینت جاوا استفاده می کند
// The BlogId for the http://buzz.blogger.com/ 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-PagesList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List pagesListAction = blogger.pages().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
pagesListAction.setFields("items(content,title,updated,url)");
// This step sends the request to the server.
PageList pages = pagesListAction.execute();
// Now we can navigate the response.
if (pages.getItems() != null && !pages.getItems().isEmpty()) {
for (Page page : pages.getItems()) {
System.out.println("Title: " + page.getTitle());
System.out.println("URL: " + page.getUrl());
System.out.println("Last Updated:" + page.getUpdated());
System.out.println("Content: " + page.getContent());
}
}
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.