یک پست را بر اساس مسیر بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
اگر پست در وبلاگی خصوصی باشد، مجوز لازم است.
مسیر یک پست بخشی از URL پست بعد از میزبان است. به عنوان مثال، یک پست وبلاگ با URL http://code.blogger.com/2011/09/blogger-json-api-now-available.html
دارای مسیر /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 | مقادیر قابل قبول عبارتند از:
|
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Posts را در بدنه پاسخ برمی گرداند.
نمونه ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه کلاینت جاوا استفاده می کند
// 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 زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.