מדריך עזר

חשוב: זאת גרסה ישנה של הדף. לגרסה העדכנית ביותר, יש להשתמש בקישורים בסרגל הניווט הימני.

מסמך זה מספק תיעוד מפורט של הפרוטוקול הגולמי (XML ו-HTTP) של ממשק ה-API של Blogger.

המסמך לא מכיל מידע על ספריות הלקוח בשפת התכנות. למידע על עיון בספריית הלקוח, עיינו בקישורים מהקטעים הספציפיים לשפת התכנות במדריך למפתחים.

תוכן עניינים

1. קהל
2. סוגי פידים של Blogger
3. הפניה לפרמטרים של שאילתה ב-Blogger
4. הפניה לרכיבי Blogger
   1. טיוטות של רשומות
   2. תאריכי פרסום ותאריכים מעודכנים
   3. קישור תגובות לפוסטים

Audience

המסמך הזה מיועד למתכנתים שרוצים לכתוב אפליקציות לקוח שיכולות לקיים אינטראקציה עם Blogger.

זהו מסמך עזר; הוא מניח שאתם מבינים את התפיסות המוצגות במדריך למפתחים ואת הרעיונות הכלליים שמאחורי פרוטוקול Google Data APIs.

סוגי פידים של Blogger

Blogger מספק שני ייצוגים של תוכן הבלוג בפידים: פידים מלאים ופידים של סיכום. פיד מלא מכיל פוסטים מלאים בבלוג, ואילו פיד סיכום מכיל רק קטע טקסט קצר מכל פוסט.

בעלים של בלוג יכולים לציין, באמצעות הגדרות GUI, אם הבלוג מספק עדכון מלא או עדכון סיכום למפיצי נתונים ואתרי אגרגטור.

כשאפליקציית הלקוח שולחת בקשה לא מאומתת של פיד, היא מקבלת את סוג הפיד שצוין על ידי בעל הבלוג.

אבל כשאפליקציית הלקוח שולחת בקשה מאומתת, היא תמיד מקבלת פיד מלא, גם אם הבעלים של הבלוג ציינו זאת.

הפניה לפרמטרים של שאילתה ב-Blogger

ה-Blogger Data API תומך כמעט בכל הפרמטרים הרגילים של Google Data APIs.

Blogger לא תומך בפרמטרים q (חיפוש טקסט) ו-author.

המערכת מתעלמת מפרמטרים של שאילתות updated-min ו-updated-max, אלא אם הפרמטר orderby מוגדר לערך updated. לדוגמה, כתובת האתר הבאה מאחזרת את כל הפוסטים של בלוגים שעודכנו מ-16 במרץ 2008 עד 24 במרץ 2008:

http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated

פירוט הרכיבים של Blogger

ה-Blogger Data API משתמש רק ברכיבי Atom סטנדרטיים. למידע נוסף, עיינו במפרט פורמט ההפצה של Atom 1.0 ובפרוטוקול הפרסום של Atom.

שאר הסעיף הזה מספק כמה הערות ספציפיות לגבי השימוש ב-Blogger&#39.

טיוטות של רשומות

רשומה בבלוג הטיוטה מסומנת באמצעות רכיב התוסף <app:draft> שהוגדר במסמך Atom Publishing Protocol. הנה דוגמה לרשומת טיוטה:

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

אם לא צוין רכיב <draft>, הרשומה לא תהיה טיוטה.

תאריכי פרסום ותאריכים מעודכנים

חותמת הזמן שצוינה ברכיב Atom <published> המתאים תואמת ל-"post date" שהמשתמש יכול להגדיר ב-GUI של Blogger.

כשהלקוח יוצר רשומה חדשה, אם הלקוח לא מציין ערך עבור <published>, Blogger מגדיר את תאריך הפוסט של הרשומה לזמן השרת הנוכחי. כשהלקוח עורך רשומה, אבל לא מציין ערך של <published>, מערכת Blogger תשאיר את תאריך הפרסום בלבד.

עם זאת, אם הלקוח מציין ערך עבור הרכיב <published> בזמן היצירה או העריכה של רשומה, מערכת Blogger מגדירה את תאריך הפרסום של הרשומה לערך שצוין. אפשרות זו יכולה להיות שימושית במשימות כמו ייבוא רשומות ישנות ממערכת בלוגים אחרת (תוך שמירה על תאריכי היצירה המקוריים).

Blogger משתמש ברכיב Atom <updated> הרגיל כדי לציין מתי הרשומה האחרונה שונתה. הלקוח שלך לא יכול לשלוט בערך <updated>. Blogger תמיד מגדיר את תאריך העדכון האחרון של הרשומה כך שבזמן השרת הנוכחי יפרסם או יערוך רשומה.

ניתן להשתמש בפרמטרים הרגילים של published-min Google API API, published-max, updated-min ו-updated-max כדי לבקש ערכים על סמך ערכי <published> או <updated> שלהם. עם זאת, הערות לגבי שאילתות בתאריכים מעודכנים מפורטות בחומר העזר בנושא פרמטרים של שאילתות ב-Blogger.

קישור תגובות לפוסטים

פורמט הייצוא של Blogger מכיל גם פוסטים וגם רשומות של תגובות במסמך אחד של פיד Atom. כדי להבחין בין שני סוגי הערכים, Blogger משתמש ברכיב <atom:category>. האלמנט הזה יכלול פרמטר term שישקף אם הרשומה היא של פוסט או של תגובה.

בנוסף, אפשר לקשר את רשומת התגובה לרשומה שאליה היא שייכת באמצעות התוסף Threading Atom. בדוגמה הבאה, הרכיב <thr:in-reply-to> ברשומת התגובה יצביע על הפוסט באמצעות מזהה רשומת הפוסט בפרמטר ref. הוא גם מקשר לכתובת ה-URL של ה-HTML של הפוסט באמצעות הפרמטר href.

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

חזרה למעלה