חשוב: ב-30 בספטמבר 2024 נפסיק את התמיכה בגרסה 2.0 של Google Data API. כדי להבטיח פונקציונליות מתמשכת, צריך לעדכן את האפליקציות שמסתמכות על v2.0 Google Data API לגרסה האחרונה של ה-API. בגרסה העדכנית ביותר, משתמשים בקישורים שבסרגל הניווט הימני. הערה: אומנם עדיין תהיה תמיכה בבקשות GET מסוימות (כמו פוסטים של כרטיסי מוצר) ככתובות URL של פידים, אבל יש הבדלים קלים בהתנהגות שלהן. מידע מפורט זמין במרכז העזרה של Blogger.
במסמך הזה תמצאו מסמכי עזר מפורטים לפרוטוקול הגולמי (XML ו-HTTP) של Blogger Data API.
המסמך לא מכיל מידע על ספריות הלקוח בשפת התכנות. לקבלת מידע על ספריית הלקוח בספריית הלקוח, עיינו בקישורים מהקטעים הספציפיים לשפת התכנות במדריך למפתחים.
תוכן עניינים
קהל
המסמך הזה מיועד למתכנתים שרוצים לכתוב אפליקציות לקוח שיכולות לקיים אינטראקציה עם Blogger.
זהו מסמך עזר. הוא מתבסס על ההנחה שאתם מבינים את המושגים שמוצגים במדריך למפתחים ואת הרעיונות הכלליים שמאחורי פרוטוקול Google Data APIs.
סוגי פידים ב-Blogger
ב-Blogger יש שתי ייצוגים של תוכן הבלוג בפידים: פידים מלאים ופידים של סיכום. עדכון מלא מכיל פוסטים מלאים בבלוג, בעוד שעדכון סיכום מכיל רק קטע קצר מכל פוסט.
בעלי הבלוג יכולים לציין, באמצעות הגדרות GUI, אם הבלוג יספק פיד מלא או פיד סיכום למפיצים ולאתרי אגרגטור.
כשאפליקציית הלקוח שולחת בקשה לא מאומתת לעדכון, היא מקבלת את סוג הפיד שבעל הבלוג ציין.
עם זאת, כשאפליקציית הלקוח שולחת בקשה מאומתת, היא תמיד מקבלת פיד מלא, ללא קשר לפרטים שצוינו על ידי בעלי הבלוג.
הפניה לפרמטרים של שאילתות ב-Blogger
ה-Blogger Data API תומך כמעט בכל הפרמטרים הרגילים של שאילתות ב-Google Data API.
Blogger לא תומך בפרמטר 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 Publishing Protocol.
בהמשך החלק הזה קיימות כמה הערות ספציפיות לגבי השימוש של Blogger בכמה רכיבים סטנדרטיים.
טיוטות של רשומות
רשומת טיוטה של בלוג מסומנת באמצעות רכיב התוסף <app:draft> שמוגדר במסמך Atom Advertising Protocol. דוגמה לטיוטה של רשומה:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
אם לא צוין רכיב <draft>, אז הרשומה היא לא טיוטה.
תאריכי פרסום ותאריכי פרסום מעודכנים
חותמת הזמן שצוינה ברכיב <published> הסטנדרטי של Atom תואמת ל'תאריך הפוסט' שמשתמש יכול להגדיר ב-GUI של Blogger.
כשהלקוח יוצר רשומה חדשה, אם הלקוח לא מציין ערך עבור <published>, Blogger מגדיר את תאריך הפרסום של הרשומה לזמן הנוכחי בשרת. כשהלקוח עורך רשומה אבל לא מציין ערך <published>, מערכת Blogger תשאיר את תאריך הפרסום שלו לבד.
עם זאת, אם הלקוח מציין ערך לרכיב <published> במהלך היצירה או העריכה של רשומה, Blogger יגדיר את תאריך הפרסום של הרשומה לערך שצוין. זה יכול להיות שימושי למשימות כמו ייבוא רשומות ישנות ממערכת בלוגים אחרת (תוך שמירה על תאריכי היצירה המקוריים).
Blogger משתמש ברכיב <updated> של Atom הרגיל כדי לציין מתי הערך האחרון השתנה. ללקוח שלכם אין אפשרות לשלוט בערך <updated>. Blogger תמיד מגדיר את תאריך העדכון האחרון של הרשומה לזמן השרת הנוכחי בכל פעם שהלקוח מפרסם או עורך רשומה.
אפשר להשתמש בפרמטרים הרגילים של שאילתות ב-Google Data API published-min,
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/opensearch/1.1/"
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 comment</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>