Thứ Ba, 24 tháng 9, 2019

Add api V3

Đăng Bởi: Admin - tháng 9 24, 2019 - 0 Bình Luận



API Blogger: Sử dụng API

API Blogger cho phép bạn tích hợp nội dung Blogger với ứng dụng của mình bằng cách sử dụng API REST. Trước khi bạn bắt đầu, bạn sẽ cần phải thiết lập ủy quyền.

Giới thiệu

Tài liệu này dành cho các nhà phát triển muốn viết các ứng dụng có thể tương tác với API Blogger. Blogger là một công cụ để tạo các trang web cho phép mọi người xuất bản suy nghĩ của họ trên cơ sở liên tục.
Nếu bạn không quen thuộc với các khái niệm Blogger, bạn nên đọc Bắt đầu trước khi bắt đầu viết mã.

Cho phép yêu cầu và xác định ứng dụng của bạn

Mọi yêu cầu mà ứng dụng của bạn gửi tới API Blogger cần xác định ứng dụng của bạn với Google. Có hai cách để xác định ứng dụng của bạn: sử dụng mã thông báo OAuth 2.0 (cũng cho phép yêu cầu) và / hoặc sử dụng khóa API của ứng dụng . Dưới đây là cách xác định tùy chọn nào sẽ sử dụng:
  • Nếu yêu cầu yêu cầu ủy quyền (chẳng hạn như yêu cầu dữ liệu riêng tư của một cá nhân), thì ứng dụng phải cung cấp mã thông báo OAuth 2.0 với yêu cầu. Ứng dụng cũng có thể cung cấp khóa API, nhưng nó không phải.
  • Nếu yêu cầu không yêu cầu ủy quyền (chẳng hạn như yêu cầu dữ liệu công khai), thì ứng dụng phải cung cấp khóa API hoặc mã thông báo OAuth 2.0 hoặc cả hai tùy chọn bất kỳ tùy chọn nào thuận tiện nhất cho bạn.

Về giao thức ủy quyền

Ứng dụng của bạn phải sử dụng OAuth 2.0 để ủy quyền các yêu cầu. Không có giao thức ủy quyền khác được hỗ trợ. Nếu ứng dụng của bạn sử dụng Đăng nhập Google , một số khía cạnh ủy quyền sẽ được xử lý cho bạn.

Cho phép các yêu cầu với OAuth 2.0

Yêu cầu API Blogger cho dữ liệu người dùng không công khai phải được ủy quyền bởi người dùng được xác thực.
Quá trình này được tạo điều kiện với ID khách OAuth.
Nhận ID khách hàng OAuth
Hoặc tạo một cái trong trang Thông tin xác thực .
Các chi tiết của quy trình ủy quyền hoặc "dòng chảy" cho OAuth 2.0 khác nhau tùy thuộc vào loại ứng dụng bạn đang viết. Quy trình chung sau đây áp dụng cho tất cả các loại ứng dụng:
  1. Khi ứng dụng của bạn cần quyền truy cập vào dữ liệu người dùng, nó sẽ yêu cầu Google cung cấp phạm vi truy cập cụ thể .
  2. Google hiển thị màn hình đồng ý cho người dùng, yêu cầu họ cho phép ứng dụng của bạn yêu cầu một số dữ liệu của họ.
  3. Nếu người dùng chấp thuận, thì Google cung cấp cho ứng dụng của bạn mã thông báo truy cập ngắn hạn .
  4. Ứng dụng của bạn yêu cầu dữ liệu người dùng, đính kèm mã thông báo truy cập vào yêu cầu.
  5. Nếu Google xác định rằng yêu cầu của bạn và mã thông báo là hợp lệ, nó sẽ trả về dữ liệu được yêu cầu.
Một số luồng bao gồm các bước bổ sung, chẳng hạn như sử dụng mã thông báo làm mới để có được mã thông báo truy cập mới. Để biết thông tin chi tiết về các luồng cho các loại ứng dụng khác nhau, hãy xem tài liệu OAuth 2.0 của Google .
Đây là thông tin phạm vi OAuth 2.0 cho API Blogger:
https://www.googleapis.com/auth/blogger
Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cần có thông tin phạm vi, cũng như thông tin mà Google cung cấp khi bạn đăng ký ứng dụng của mình (chẳng hạn như ID khách hàng và bí mật của máy khách).
Mẹo: Thư viện khách Google API có thể xử lý một số quy trình ủy quyền cho bạn. Chúng có sẵn cho nhiều ngôn ngữ lập trình; kiểm tra trang với các thư viện và mẫu để biết thêm chi tiết.

Nhận và sử dụng khóa API 

Yêu cầu API Blogger cho dữ liệu công khai phải được kèm theo một mã định danh, có thể là khóa API hoặc mã thông báo truy cập .
Lấy chìa khóa
Hoặc tạo một cái trong trang Thông tin xác thực .
Sau khi bạn có khóa API, ứng dụng của bạn có thể nối tham số truy vấn vào tất cả các URL yêu cầu.key=yourAPIKey
Khóa API an toàn để nhúng URL; nó không cần mã hóa.

Làm việc với blog

Lấy một blog

Bạn có thể truy xuất thông tin cho một blog cụ thể bằng cách gửi GETyêu cầu HTTP đến URI của blog. URI cho một blog có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 2399953 ? Key = Your -API-KEY
Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng 200 OKmã trạng thái HTTP và dữ liệu blog:
{
  "loại": "blogger # blog",
  "id": "2399953",
  "tên": "Blogger Buzz",
  "Mô tả": "Buzz chính thức từ Blogger tại Google",
  "đã xuất bản": "2007-04-23T22: 17: 29.261Z",
  "Đã cập nhật": "2011-08 / 02T06: 01: 15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953",
  "bài viết": {
    "TotalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts"
  },
  "trang": {
    "TotalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/pages"
  },
  "miền địa phương": {
    "ngôn ngữ: Việt nam",
    "Quốc gia": "",
    "biến thể": ""
  }
}

Lấy một blog bằng URL của nó

Bạn có thể truy xuất blog bằng URL của nó bằng cách gửi GET yêu cầu HTTP đến URI sau với urltham số:
https://www.googleapis.com/blogger/v3/bloss/byurl?url= blog-url

Yêu cầu

https://www.googleapis.com/blogger/v3/bloss/byurl?url= http://code.blogger.com/

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và đại diện đầy đủ của blog đã xác định:
{
 "loại": "blogger # blog",
 "id": "3213900",
 "tên": "Mạng lưới nhà phát triển Blogger",
 "Mô tả": "Nhật ký web chính thức của Nhà phát triển Blogger.",
 "đã xuất bản": "2007 / 02-09T10: 13: 10-08: 00",
 "Đã cập nhật": "2012-04-15T19: 38: 01-07: 00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/bloss/3213900",
 "bài viết": {
  "TotalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/3213900/posts"
 },
 "trang": {
  "TotalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/3213900/pages"
 },
 "miền địa phương": {
  "ngôn ngữ: Việt nam",
  "quốc gia": "Mỹ",
  "biến thể": ""
 }
}

Lấy blog của người dùng

Bạn có thể truy xuất danh sách các blog của người dùng bằng cách gửi GETyêu cầu HTTP đến bộ sưu tập blog URI:
https://www.googleapis.com/blogger/v3/users/ userId / blog

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/users/elf/bloss
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Lưu ý : Người dùng phải được xác thực để liệt kê các blog của riêng họ, vì vậy bạn phải cung cấp Authorizationtiêu đề HTTP với GETyêu cầu.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng 200 OKmã trạng thái HTTP và thể hiện đầy đủ danh sách các blog của người dùng:
{
  "loại": "blogger # blogList",
  "mặt hàng": [
    {
      "loại": "blogger # blog",
      "id": "4967929378133675647",
      "tên": "Brett's Test Blawg",
      "sự miêu tả": "",
      "đã xuất bản": "2010-10-06T23: 33: 31.662Z",
      "Đã cập nhật": "2011-08-08T06: 50: 02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v3/bloss/4967929378133675647",
      "bài viết": {
        "TotalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/bloss/4967929378133675647/posts"
      },
      "trang": {
        "TotalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/bloss/4967929378133675647/pages"
      },
      "miền địa phương": {
        "ngôn ngữ: Việt nam",
        "Quốc gia": "",
        "biến thể": ""
      }
    }
  ]
}

Làm việc với bài viết

Lấy bài viết từ blog

Bạn có thể truy xuất danh sách các bài đăng từ một blog nhất định bằng cách gửi GETyêu cầu đến URI bộ sưu tập bài đăng. URI cho bộ sưu tập bài viết có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết

Yêu cầu

Đây là một ví dụ:
NHẬN https://www.googleapis.com/blogger/v3/bloss/ 2399953 / bài đăng? Key = Your -API-KEY
Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và danh sách các bài đăng:
{
  "loại": "blogger # postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "trướcPageToken": "CgkIChDBwrK3mCYQ0b2SAQ",
  "mặt hàng": [
    {
      "loại": "blogger # bài",
      "id": "7706273476706534553",
      "Blog": {
        "id": "2399953"
      },
      "đã xuất bản": "2011-08-01T19: 58: 00.000Z",
      "Đã cập nhật": "2011-08-01T19: 58: 51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553",
      "title": "Cập nhật mới nhất, ngày 1 tháng 8",
      "nội dung": "được hỗ trợ cho khả năng đọc ",
      "tác giả": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "Hình ảnh, tưởng tượng": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "trả lời": {
        "TotalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "loại": "blogger # bài",
      "id": "6069922188027612413",
      trốn tránh để dễ đọc
    }
  ]
}

Lấy một bài đăng cụ thể

Bạn có thể truy xuất một bài đăng cụ thể từ blog bằng cách gửi GETyêu cầu tới URI tài nguyên bài đăng. URI cho tài nguyên bài đăng có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / postId

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 2399953 / bài viết / 7706273476706534553 ? Key = Your -API-KEY
Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
  "loại": "blogger # bài",
  "id": "7706273476706534553",
  "Blog": {
    "id": "2399953"
  },
  "đã xuất bản": "2011-08-01T19: 58: 00.000Z",
  "Đã cập nhật": "2011-08-01T19: 58: 51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553",
  "title": "Cập nhật mới nhất, ngày 1 tháng 8",
  "nội dung": "được hỗ trợ cho khả năng đọc ",
  "tác giả": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "Hình ảnh, tưởng tượng": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "trả lời": {
    "TotalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553/comments"
  }
}

Tìm kiếm một bài viết

Bạn có thể tìm kiếm các bài đăng từ blog bằng cách gửi GETyêu cầu tới URI tìm kiếm bài đăng với tham số truy vấn tìm kiếm q:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / tìm kiếm? q = thuật ngữ truy vấn

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/3213900/posts/search?q= document & key = Your-API-KEY
Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
  "loại": "blogger # postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "trướcPageToken": "CgkIChDBq5v24yYQzJTEAQ",
  "mặt hàng": [
  {
    "loại": "blogger # bài",
    "id": "1387873546480002228",
    "Blog": {
      "id": "3213900"
    },
    "đã xuất bản": "2012 / 03-23T01: 58: 00-07: 00",
    "Đã cập nhật": "2012 / 03-23T01: 58: 12-07: 00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-mond-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/bloss/3213900/posts/1387873546480002228",
    "title": "Tài liệu Blogger đã được chuyển sang developers.google.com",
    "nội dung": " nội dung được hỗ trợ để dễ đọc ",
    "tác giả": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "Hình ảnh, tưởng tượng": {
        "url": "https://resource.blogblog.com/img/b16-rounded.gif"
      }
    },
    "trả lời": {
      "TotalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/bloss/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

Thêm một bài viết

Bạn có thể thêm một bài đăng cho một blog bằng cách gửi POSTyêu cầu đến URI của bộ sưu tập bài đăng với phần thân JSON của bài đăng:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết /

Yêu cầu

POST https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Loại nội dung: ứng dụng / json

{
  "loại": "blogger # bài",
  "Blog": {
    "id": "8070105920543249955"
  },
  "tiêu đề": "Một bài viết mới",
  "nội dung": "Với nội dung <b> thú vị </ b> ..."
}
Bạn phải được xác thực để tạo một bài viết.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
 "loại": "blogger # bài",
 "id": "6819100329896798058",
 "Blog": {
  "id": "8070105920543249955"
 },
 "đã xuất bản": "2012-05-20T20: 08: 00-07: 00",
 "Đã cập nhật": "2012-05-20T20: 08: 35-07: 00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058",
 "tiêu đề": "Một bài viết mới",
 "nội dung": "Với nội dung <b> thú vị </ b> ...",
 "tác giả": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "Hình ảnh, tưởng tượng": {
   "url": "https://resource.blogblog.com/img/b16-rounded.gif"
  }
 },
 "trả lời": {
  "TotalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Xóa một bài viết

Bạn có thể xóa bài đăng cho blog bằng cách gửi DELETEyêu cầu tới URI tài nguyên bài đăng:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / postId

Yêu cầu

Đây là một ví dụ:
XÓA https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Bạn phải được xác thực để xóa một bài viết.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng 200 OKmã trạng thái HTTP .

Lấy một bài đăng bằng đường dẫn của nó

Bạn có thể truy xuất một bài đăng từ blog bằng cách gửi GETyêu cầu đến các bài đăng bằng cách paththông qua URI với một tham số. URI cho một bài viết theo yêu cầu đường dẫn có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / bypath? path = post-path

Yêu cầu

https://www.googleapis.com/blogger/v3/bloss/ 2399953 / bài đăng / bypath? path = /2011/08/latest-updates-august-1st.html & key = Your -API-KEY
Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
  "loại": "blogger # bài",
  "id": "7706273476706534553",
  "Blog": {
    "id": "2399953"
  },
  "đã xuất bản": "2011-08-01T19: 58: 00.000Z",
  "Đã cập nhật": "2011-08-01T19: 58: 51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553",
  "title": "Cập nhật mới nhất, ngày 1 tháng 8",
  "nội dung": "được hỗ trợ cho khả năng đọc ",
  "tác giả": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "Hình ảnh, tưởng tượng": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "trả lời": {
    "TotalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/7706273476706534553/comments"
  }
}

Cập nhật một bài viết

Bạn có thể cập nhật bài đăng cho blog bằng cách gửi PUTyêu cầu tới URI tài nguyên bài đăng với phần thân JSON của bài đăng:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / postId

Yêu cầu

PUT https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts 43245355871727114160
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Loại nội dung: ứng dụng / json

{
 "loại": "blogger # bài",
 "id": "3445355871727114160",
 "Blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts 43245355871727114160",
 "tiêu đề": "Một bài đăng cập nhật",
 "nội dung": "Với nội dung thực sự <b> thú vị </ b> ..."
}
Bạn phải được xác thực để cập nhật một bài viết.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
 "loại": "blogger # bài",
 "id": "6819100329896798058",
 "Blog": {
  "id": "8070105920543249955"
 },
 "đã xuất bản": "2012-05-20T20: 08: 00-07: 00",
 "Đã cập nhật": "2012-05-20T20: 08: 35-07: 00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058",
 "tiêu đề": "Một bài đăng cập nhật",
 "nội dung": "Với nội dung thực sự <b> thú vị </ b> ...",
 "tác giả": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "Hình ảnh, tưởng tượng": {
   "url": "https://resource.blogblog.com/img/b16-rounded.gif"
  }
 },
 "trả lời": {
  "TotalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Cập nhật một bài đăng với ngữ nghĩa vá

Bạn có thể cập nhật một bài đăng với ngữ nghĩa vá bằng cách gửi PATCH yêu cầu đến URI tài nguyên bài đăng với phần thân JSON của bài đăng:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / postId

Yêu cầu

Đây là một ví dụ:
VÒI https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts 43245355871727114160
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Loại nội dung: ứng dụng / json

{
 "nội dung": "Với nội dung <b> tuyệt vời </ b> ..."
}
Bạn phải được xác thực để cập nhật một bài viết.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và nội dung của bài đăng:
{
 "loại": "blogger # bài",
 "id": "6819100329896798058",
 "Blog": {
  "id": "8070105920543249955"
 },
 "đã xuất bản": "2012-05-20T20: 08: 00-07: 00",
 "Đã cập nhật": "2012-05-20T20: 08: 35-07: 00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058",
 "tiêu đề": "Một bài đăng cập nhật",
 "nội dung": "Với nội dung <b> tuyệt vời </ b> ...",
 "tác giả": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "Hình ảnh, tưởng tượng": {
   "url": "https://resource.blogblog.com/img/b16-rounded.gif"
  }
 },
 "trả lời": {
  "TotalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Làm việc với ý kiến

Lấy ý kiến ​​cho một bài viết

Bạn có thể truy xuất danh sách các bình luận cho một bài đăng bằng cách gửi GETyêu cầu đến URI bộ sưu tập ý kiến. URI cho bộ sưu tập nhận xét có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / bài viết / postId / bình luận

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 2399953 / bài viết / 6069922188027612413 / bình luận? Key = Your -API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và danh sách các bình luận:
{
  "loại": "blogger # bình luận",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "trướcPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "mặt hàng": [
    {
       "loại": "blogger # bình luận",
       "id": "9200761938824362519",
       "bài đăng": {
         "id": "6069922188027612413"
       },
       "Blog": {
         "id": "2399953"
       },
       "đã xuất bản": "2011 / 07-28T19: 19: 57.740Z",
       "Đã cập nhật": "2011 / 07-28T21: 29: 42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "nội dung": " trốn tránh ",
       "tác giả": {
         "id": "530579030283",
         "displayName": " elided ",
         "url": "đã bỏ qua ",
         "Hình ảnh, tưởng tượng": {
           "url": "đã bỏ qua "
         }
       }
    },
    {
      "loại": "blogger # bình luận",
      "id": "400101178920857170",
      trốn tránh để dễ đọc
    }
  ]
}

Lấy một bình luận cụ thể

Bạn có thể truy xuất một nhận xét cụ thể từ một bài đăng bằng cách gửi GETyêu cầu tới URI tài nguyên nhận xét. URI cho tài nguyên nhận xét có định dạng sau:
https://www.googleapis.com/blogger/v3/blogs/ blogId / posts / postID / ý kiến / commentId

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 2399953 / bài viết / 6069922188027612413 / bình luận / 9200761938824362519 ? Key = Your -API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và dữ liệu nhận xét:
{
  "loại": "blogger # bình luận",
  "id": "9200761938824362519",
  "bài đăng": {
    "id": "6069922188027612413"
  },
  "Blog": {
    "id": "2399953"
  },
  "đã xuất bản": "2011 / 07-28T19: 19: 57.740Z",
  "Đã cập nhật": "2011 / 07-28T21: 29: 42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "nội dung": " trốn tránh ",
  "tác giả": {
    "id": "530579030283",
    "displayName": " elided ",
    "url": "đã bỏ qua ",
    "Hình ảnh, tưởng tượng": {
      "url": "đã bỏ qua "
    }
  }
}

Làm việc với các trang

Lấy trang cho blog

Bạn có thể truy xuất danh sách các trang cho blog bằng cách gửi GETyêu cầu đến URI bộ sưu tập trang. URI cho bộ sưu tập trang có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / page

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 4967929378133675647 / trang? Key = Your -API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và danh sách các trang:
{
  "loại": "blogger # pageList",
  "mặt hàng": [
    {
      "loại": "blogger # trang",
      "id": "273541696466681878",
      "Blog": {
        "id": "4967929378133675647"
      },
      "đã xuất bản": "2011-07-14T16: 16: 00.000Z",
      "Đã cập nhật": "2011-07-14T16: 16: 23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/bloss/4967929378133675647/pages/273541696466681878",
      "tiêu đề": "Nội dung tĩnh",
      "nội dung": "được hỗ trợ cho khả năng đọc ",
      "tác giả": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "Hình ảnh, tưởng tượng": {
          "url": "https://resource.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

Lấy một trang cụ thể

Bạn có thể truy xuất một trang cụ thể từ blog bằng cách gửi GETyêu cầu tới URI tài nguyên trang. URI cho một trang Tài nguyên có định dạng sau:
https://www.googleapis.com/blogger/v3/bloss/ blogId / page / pageId

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/bloss/ 4967929378133675647 / page / 273541696466681878 ? Key = Your -API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồm Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng 200 OKmã trạng thái HTTP và dữ liệu trang:
{
  "loại": "blogger # trang",
  "id": "273541696466681878",
  "Blog": {
    "id": "4967929378133675647"
  },
  "đã xuất bản": "2011-07-14T16: 16: 00.000Z",
  "Đã cập nhật": "2011-07-14T16: 16: 23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/bloss/4967929378133675647/pages/273541696466681878",
  "tiêu đề": "Nội dung tĩnh",
  "nội dung": "được hỗ trợ cho khả năng đọc ",
  "tác giả": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "Hình ảnh, tưởng tượng": {
      "url": "https://resource.blogblog.com/img/b16-rounded.gif"
    }
  }
}

Làm việc với người dùng

Lấy một người dùng

Bạn có thể truy xuất thông tin của người dùng bằng cách gửi GETyêu cầu HTTP đến URI tài nguyên của người dùng:
https://www.googleapis.com/blogger/v3/users/ userId

Yêu cầu

NHẬN https://www.googleapis.com/blogger/v3/users/elf
Ủy quyền: / * Mã thông báo OAuth 2.0 tại đây * /
Lưu ý : Người dùng phải được xác thực để liệt kê thông tin của riêng họ, vì vậy bạn phải cung cấp Authorizationtiêu đề HTTP với GETyêu cầu.

Phản ứng

Nếu yêu cầu thành công, máy chủ sẽ phản hồi với 200 OKmã trạng thái HTTP và liên kết đến danh sách các blog của người dùng:
{
  "loại": "blogger # người dùng",
  "id": "901569848744",
  "Tự liên kết": "https://www.googleapis.com/blogger/v3/users/901569848744",
  "blog": {
    "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/bloss"
  }
}

Thông số truy vấn tiêu chuẩn

Các tham số truy vấn sau đây có thể được sử dụng với tất cả các phương thức và tất cả tài nguyên trong API Blogger.
Các tham số truy vấn áp dụng cho tất cả các hoạt động API Blogger được hiển thị trong bảng bên dưới.
Ghi chú (trên khóa API và mã xác thực authens):
  1. Các keytham số là cần thiết với tất cả các yêu cầu, trừ khi bạn cung cấp một OAuth 2.0 mã thông báo với yêu cầu.
  2. Bạn phải gửi mã thông báo ủy quyền với mọi yêu cầu yêu cầu phạm vi OAuth. OAuth 2.0 là giao thức ủy quyền được hỗ trợ duy nhất.
  3. Bạn có thể cung cấp mã thông báo OAuth 2.0 với bất kỳ yêu cầu nào theo một trong hai cách:
    • Sử dụng access_tokentham số truy vấn như thế này:?access_token=oauth2-token
    • Sử dụng Authorizationtiêu đề HTTP như thế này:Authorization: Bearer oauth2-token
Tất cả các tham số là tùy chọn trừ khi có ghi chú.
Tham sốÝ nghĩaGhi chú
access_tokenMã thông báo OAuth 2.0 cho người dùng hiện tại.
callbackChức năng gọi lại.
  • Tên của hàm gọi lại JavaScript xử lý phản hồi.
  • Được sử dụng trong các yêu cầu JavaScript JSON-P .
fieldsBộ chọn chỉ định tập hợp con của các trường để đưa vào phản hồi.
  • Để biết thêm thông tin, hãy xem phần phản hồi một phần trong tài liệu Mẹo hiệu suất.
  • Sử dụng để có hiệu suất tốt hơn.
keyMã API. (CẦN THIẾT*)
  • * Bắt buộc trừ khi bạn cung cấp mã thông báo OAuth 2.0.
  • Khóa API của bạn xác định dự án của bạn và cung cấp cho bạn quyền truy cập, hạn ngạch và báo cáo API.
  • Lấy khóa API của dự án của bạn từ Bảng điều khiển API của Google .
prettyPrint
Trả về phản hồi với các vết lõm và ngắt dòng.
  • Trả về phản hồi ở định dạng có thể đọc được nếu true.
  • Giá trị mặc định : true.
  • Khi đó false, nó có thể giảm kích thước tải phản hồi, điều này có thể dẫn đến hiệu suất tốt hơn trong một số môi trường.
quotaUserThay thế cho userIp.
  • Cho phép bạn thực thi hạn ngạch cho mỗi người dùng từ một ứng dụng phía máy chủ ngay cả trong trường hợp không xác định được địa chỉ IP của người dùng. Điều này có thể xảy ra, ví dụ, với các ứng dụng chạy các công việc định kỳ trên Máy ứng dụng thay mặt cho người dùng.
  • Bạn có thể chọn bất kỳ chuỗi tùy ý xác định duy nhất một người dùng, nhưng nó được giới hạn ở 40 ký tự.
  • Ghi đè userIpnếu cả hai được cung cấp.
  • Tìm hiểu thêm về việc sử dụng API .
userIpĐịa chỉ IP của người dùng cuối mà cuộc gọi API đang được thực hiện.
  • Cho phép bạn thực thi hạn ngạch cho mỗi người dùng khi gọi API từ ứng dụng phía máy chủ.
  • Tìm hiểu thêm về việc sử dụng API .

Trang này có hữu ích không?


https://www.youtube.com/watch?v=cqIGCb9mTRU












Phản Hồi Độc Giả

Một số lưu ý khi bình luận

Mọi bình luận sai nội quy sẽ bị xóa mà không cần báo trước (xem nội quy)

Bấm Thông báo cho tôi bên dưới khung bình luận để nhận thông báo khi admin trả lời

Để bình luận một đoạn code, hãy mã hóa code trước nhé