الصفحات: قائمة

يسترجع قائمة الصفحات لإحدى المدونات. جرِّب ذلك الآن أو اطّلِع على مثال.

يجب الحصول على الإذن إذا كانت الصفحات مضمّنة في مدونة خاصة. إذا كانت الصفحات معروضة على مدوّنة علنية، يمكن استدعاء هذه الطريقة بدون إذن.

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
المَعلمات المطلوبة
blogId string رقم تعريف المدوّنة التي تريد جلب الصفحات منها.
المَعلمات الاختيارية
fetchBodies boolean ما إذا كان سيتم استرداد نصوص الصفحات.
status string

القِيَم المقبولة هي:
  • "draft": صفحات مسودّة (لم يتم نشرها)
  • "imported": الصفحات التي تمت إزالة محتواها
  • "live": الصفحات الظاهرة للجميع
view string

القِيَم المقبولة هي:
  • "ADMIN": تفاصيل على مستوى المشرف
  • "AUTHOR": تفاصيل على مستوى المؤلف
  • "READER": تفاصيل على مستوى المشرف

نص الطلب

لا تقدِّم محتوى طلب باستخدام هذه الطريقة.

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "blogger#pageList",
  "items": [
    pages Resource
  ]
}
اسم الموقع القيمة الوصف ملاحظات
kind string نوع هذا الكيان. blogger#pageList دائمًا
items[] list قائمة "مراجع الصفحات" للمدوّنة المحدّدة

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

استخدام مكتبة برامج Java

// 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());
}
}

جرّب الآن

استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.