يسترد المشاركات حسب المسار. جرِّب الخدمة الآن أو اطّلِع على مثال.
يجب الحصول على إذن الوصول إذا كانت المشاركة على مدونة خاصة.
مسار المشاركة هو الجزء الذي يلي المضيف في عنوان 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 |
في ما يلي القيم المقبولة:
|
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض مورد المشاركات في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
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());
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.