เมธอดของ API

GetReader

GetReader ช่วยให้ผู้เผยแพร่โฆษณาตรวจสอบได้ว่าผู้อ่านรายหนึ่งของตนที่มี PPID ที่รู้จักได้ลิงก์การสมัครใช้บริการของตนกับ Google แล้วหรือไม่ เมื่อใช้คำขอ GET ผู้เผยแพร่โฆษณาจะค้นหา PPID ที่เป็นของรหัสสื่อเผยแพร่หนึ่งๆ

ส่งคำขอ

//GET /v1/publications/dailybugle.com/readers/6789

คำตอบ

ปลายทางจะแสดงผล 200 ที่มีเนื้อหา JSON ที่มี created_time ของการสมัครใช้บริการที่ลิงก์ หรือข้อผิดพลาดหากไม่พบ PPID สำหรับสื่อเผยแพร่ ดูข้อมูลเพิ่มเติมได้ที่ส่วนข้อผิดพลาด

{
  "name": "publications/gtech-demo.appspot.com/readers/81112",  
  "create_time": "2022-04-19T04:53:40+00:00"
}

GetReaderEntitlements

GetReaderEntitlements อนุญาตให้ผู้เผยแพร่โฆษณาค้นหาการให้สิทธิ์สำหรับ PPID ที่ผู้เผยแพร่โฆษณาระบุไว้ก่อนหน้านี้ เมื่อใช้คำขอ GET ผู้เผยแพร่จะขอการให้สิทธิ์โดยระบุ PPID และรหัสสื่อเผยแพร่

ส่งคำขอ

//GET /v1/publications/dailybugle.com/readers/6789/entitlements

คำตอบ

หากต้องการให้คำขอประสบความสำเร็จ รูปแบบการคืนสินค้าจะเหมือนกับรูปแบบที่ใช้ในการจัดเก็บการให้สิทธิ์ที่มี คำขอ UpdateReaderEntitlements PATCH

{ 
  "name": "publications/dailybugle.com/readers/6789/entitlements",
  "entitlements": [  
      {
        "product_id": "dailybugle.com:basic",
        "subscription_token": "dnabhdufbwinkjanvejskenfw",
        "detail": "This is our basic plan",
        "expire_time": "2022-08-19T04:53:40+00:00"
      },
      {
        "product_id": "dailybugle.com:premium",
        "subscription_token": "wfwhddgdgnkhngfw",
        "detail": "This is our premium plan",
        "expire_time": "2022-07-19T04:53:40+00:00"
      },
      {
        "product_id": "dailybugle.com:deluxe",
        "subscription_token": "fefcbwinkjanvejfefw",
        "detail": "This is our deluxe plan",
        "expire_time": "2022-08-20T04:53:40+00:00"
      }
  ]
}

สำหรับผู้ใช้ที่ไม่มีสิทธิ์ แต่มี PPID ที่ลิงก์ (เช่น การให้สิทธิ์ที่หมดอายุแล้วหรือถูกลบออก) คำขอการให้สิทธิ์จะแสดงอาร์เรย์การให้สิทธิ์ที่ว่างเปล่าซึ่งเป็นส่วนหนึ่งของออบเจ็กต์การให้สิทธิ์มาตรฐาน

{ 
  "name": "publications/dailybugle.com/readers/6789/entitlements",
  "createTime": "2023-02-07T17:38:57.425577Z"
}

UpdateReaderEntitlements

ใช้ UpdateReaderEntitlements เพื่อสร้างและอัปเดตการให้สิทธิ์สำหรับผู้อ่านโดยอิงตาม PPID

เพย์โหลดตัวอย่างนี้ให้สิทธิ์ PPID 6789 แก่ผู้อ่านสำหรับรหัสผลิตภัณฑ์ 3 รายการสำหรับ The Daily Bugle ซึ่งก็คือ dailybugle.com:basic, dailybugle.com:premium และ dailybugle.com:deluxe เมื่อผู้อ่าน 6789 ใช้แพลตฟอร์มของ Google สำหรับ Search และ Discover ในเวลาต่อมา รายการ "จากการสมัครรับข้อมูลของคุณ" จะแสดงผลลัพธ์ที่เกี่ยวข้องจากบทความใน Dailybugle.com ที่ติดแท็กด้วยรหัสผลิตภัณฑ์ใดๆ เหล่านี้

ส่งคำขอ

//PATCH /v1/publications/dailybugle.com/readers/6789/entitlements

{
  "name": "publications/dailybugle.com/readers/6789/entitlements",
  "entitlements": [  
      {
        "product_id": "dailybugle.com:basic",
        "subscription_token": "dnabhdufbwinkjanvejskenfw",
        "detail": "This is our basic plan",
        "expire_time": "2022-08-19T04:53:40+00:00"
      },
      {
        "product_id": "dailybugle.com:premium",
        "subscription_token": "wfwhddgdgnkhngfw",
        "detail": "This is our premium plan",
        "expire_time": "2022-07-19T04:53:40+00:00"
      },
      {
        "product_id": "dailybugle.com:deluxe",
        "subscription_token": "fefcbwinkjanvejfefw",
        "detail": "This is our deluxe plan",
        "expire_time": "2022-08-20T04:53:40+00:00"
      }
  ]
}

คำตอบ

เมื่อ Patch สำเร็จแล้ว ออบเจ็กต์ entitlements ที่บันทึกไว้จะ ที่แสดงผลในรูปแบบเดียวกับ GetReaderEntitlements

DeleteReader

DeleteReader อนุญาตให้ผู้เผยแพร่ลบการสมัครใช้บริการที่ลิงก์ไว้ของผู้อ่านได้ด้วยตนเอง เมื่อใช้คำขอ DELETE ผู้เผยแพร่เนื้อหาจะส่ง PPID สำหรับรหัสสื่อเผยแพร่ที่จะลบ

ส่งคำขอ

//DELETE /v1/publications/dailybugle.com/readers/6789

คำตอบ

การลบที่สำเร็จจะแสดง 200 ที่มีออบเจ็กต์ JSON ที่ว่างเปล่า {}

{}