פוסטים: getByPath

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

נדרשת הרשאה אם הפוסט נמצא בבלוג פרטי.

הנתיב של הפוסט הוא החלק מכתובת ה-URL של הפוסט שאחרי המארח. לדוגמה, בפוסט בבלוג עם כתובת ה-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 שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.