דפים: רשימה

אחזור של רשימת הדפים של בלוג. אפשר לנסות עכשיו או לראות דוגמה.

נדרשת הרשאה אם הדפים בבלוג פרטי. אם הדפים נמצאים בבלוג ציבורי, ניתן לקרוא לשיטה הזו ללא הרשאה.

שליחת בקשה

בקשת 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());
	}
}

רוצה לנסות?

כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, צריך להשתמש ב-APIs Explorer בהמשך.