يسترجع قائمة الصفحات لإحدى المدونات. جرِّب ذلك الآن أو اطّلِع على مثال.
يجب الحصول على الإذن إذا كانت الصفحات مضمّنة في مدونة خاصة. إذا كانت الصفحات معروضة على مدوّنة علنية، يمكن استدعاء هذه الطريقة بدون إذن.
الطلب
طلب 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 |
قائمة "مراجع الصفحات" للمدوّنة المحدّدة |
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
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());
}
}
جرّب الآن
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.