פוסטים: getByPath

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

צריך להוסיף הרשאה אם הפוסט בבלוג הוא פרטי.

הנתיב של פוסט הוא החלק שמופיע אחרי כתובת המארח בפוסט. לדוגמה, פוסט בבלוג עם כתובת ה-URL http://code.blogger.com/2011/09/blogger-json-api-now-available.html מכיל את הנתיב /2011/09/blogger-json-api-now-available.html.

שליחת בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים נדרשים
blogId string המזהה של הבלוג שממנו מגיע הפוסט.
path string נתיב הפוסט לאחזור.
פרמטרים אופציונליים
maxComments unsigned integer המספר המרבי של תגובות לאחזור עבור פוסט. אם לא תציינו את הפרמטר הזה, לא יוחזרו תגובות כחלק ממשאב הפוסט.
view string

הערכים הקבילים הם:
  • "ADMIN": פרטים ברמת אדמין
  • "AUTHOR": פרטים ברמת המחבר
  • "READER": פרטים ברמת אדמין

גוף הבקשה

אין להזין גוף בקשה בשיטה זו.

תשובה

אם הצלחת, בשיטה הזו מוחזר משאב פוסטים בגוף התגובה.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

Java

שימוש בספריית הלקוחות של Java

// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";

// The URL path component for a buzz post.
String BUZZ_POST_PATH = "/2012/01/engage-with-your-readers-through.html";

// 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-PostsGetByPath-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
GetByPath postsGetByPathAction = blogger.posts().getByPath(BUZZ_BLOG_ID);
postsGetByPathAction.setPath(BUZZ_POST_PATH);

// Restrict the result content to just the data we need.
postsGetByPathAction.setFields("content,published,title");

// This step sends the request to the server.
Post post = postsGetByPathAction.execute();

// Now we can navigate the response.
System.out.println("Title: " + post.getTitle());
System.out.println("Published: " + post.getPublished());
System.out.println("Content: " + post.getContent());

רוצה לנסות?

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