אחזור רשימת הדפים של בלוג. רוצים לנסות? או לעיון בדוגמה
הרשאה נדרשת אם הדפים נמצאים בבלוג פרטי. אם הדפים נמצאים בבלוג שגלוי לכולם, אפשר להפעיל את השיטה הזו בלי הרשאה.
בקשה
בקשת HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/pages
פרמטרים
שם הפרמטר | ערך | תיאור |
---|---|---|
פרמטרים נדרשים | ||
blogId |
string |
המזהה של הבלוג שממנו רוצים לאחזר דפים. |
פרמטרים אופציונליים | ||
fetchBodies |
boolean |
האם לאחזר את גופי הדפים. |
status |
string |
הערכים הקבילים הם:
|
view |
string |
הערכים הקבילים הם:
|
גוף הבקשה
אין לספק גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:
{ "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());
}
}
נסה בעצמך!
אפשר להשתמש ב-API Explorer שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.