API পদ্ধতি

GetReader

GetReader একটি প্রকাশককে যাচাই করার অনুমতি দেয় যদি একটি পরিচিত PPID সহ তাদের পাঠকদের মধ্যে একজন তাদের সাবস্ক্রিপশন Google-এর সাথে লিঙ্ক করে থাকে। একটি GET অনুরোধ ব্যবহার করে, প্রকাশক একটি নির্দিষ্ট প্রকাশনা আইডির অন্তর্গত একটি PPID-এর জন্য প্রশ্ন করে।

অনুরোধ

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

প্রতিক্রিয়া

এন্ডপয়েন্ট হয় একটি JSON বডি সহ একটি 200 প্রদান করবে যার মধ্যে লিঙ্ক করা সাবস্ক্রিপশনের 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 একটি পাঠকের জন্য তাদের PPID এর উপর ভিত্তি করে এনটাইটেলমেন্ট তৈরি এবং আপডেট করার জন্য ব্যবহার করা হয়।

এই নমুনা পেলোডটি PPID 6789 সহ পাঠককে The Daily Bugle-এর জন্য তিনটি পণ্য আইডিতে এনটাইটেলমেন্ট দেয়: dailybugle.com:basic , dailybugle.com:premium , এবং dailybugle.com:deluxe ৷ যখন রিডার 6789 পরবর্তীতে অনুসন্ধান এবং আবিষ্কারের জন্য Google সারফেস ব্যবহার করে, তখন "আপনার সদস্যতা থেকে" তালিকায় এই পণ্য আইডিগুলির যেকোনো একটির সাথে ট্যাগ করা 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"
      }
  ]
}

প্রতিক্রিয়া

একটি সফল প্যাচ অপারেশনের পরে, সংরক্ষিত entitlements অবজেক্টটি GetReaderEntitlements এর মতো একই বিন্যাসে ফেরত দেওয়া হবে।

ডিলিট রিডার

DeleteReader একজন প্রকাশককে ম্যানুয়ালি একজন পাঠকের লিঙ্ক করা সদস্যতা মুছে ফেলার অনুমতি দেয়। একটি DELETE অনুরোধ ব্যবহার করে, প্রকাশক একটি প্রকাশনা আইডি মুছে ফেলার জন্য একটি PPID জমা দেন।

অনুরোধ

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

প্রতিক্রিয়া

একটি সফল মুছে ফেলা একটি খালি JSON বস্তু {} সহ একটি 200 প্রদান করে।

{}