المشاركات: 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

استخدام مكتبة عميل جافا

// 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());

جرِّب هذه الميزة الآن.

استخدم مستكشف واجهات برمجة التطبيقات أدناه لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على الاستجابة.