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

جرِّبها الآن.

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