Penayang terutama menggunakan integrasi sisi server untuk mengelola pembaca dan
hak mereka. Pada dasarnya, penayang menggunakan UpdateReaderEntitlements
untuk memperbarui
data Google tentang hak ID Produk untuk PPID.
Penyiapan Google Cloud
Mengonfigurasi Penautan Langganan di Google Cloud mencakup dua komponen utama:
- Mengaktifkan API untuk project tertentu
- Membuat akun layanan untuk mengakses API
Mengaktifkan Subscription Linking API
Untuk menggunakan akun layanan dan mengelola hak pembaca, project Google Cloud
harus mengaktifkan Subscription Linking API dan akun layanan OAuth
yang dikonfigurasi dengan benar. Agar dapat mengaktifkan Subscription Linking API untuk sebuah
project, buka menu -> APIs & Services -> Library, lalu telusuri
Subscription Linking
, atau langsung buka halaman:
https://console.cloud.google.com/apis/library?project=gcp_project_id
Gambar 1. Membuka Library API, dan mengaktifkan API untuk project Google Cloud.
Membuat Akun Layanan
Akun layanan digunakan untuk mengizinkan akses dari aplikasi Anda ke Subscription Linking API.
- Buat akun layanan dalam konsol project Anda.
- Buat kredensial untuk akun layanan, dan simpan
file
credentials.json
di lokasi aman yang dapat diakses oleh aplikasi Anda. - Berikan peran IAM "Subscription Linking Admin" ke akun layanan yang Anda buat. Untuk kontrol terperinci atas kemampuan akun layanan, Anda dapat menetapkan peran yang sesuai dari tabel berikut.
Kemampuan / Peran | Admin Penautan Langganan | Pengakses Penautan Langganan | Pelihat Hak Penautan Langganan |
---|---|---|---|
Mendapatkan hak pembaca | |||
Dapatkan pembaca | |||
Memperbarui hak pembaca | |||
Hapus pembaca |
Menggunakan akun layanan dengan Subscription Linking API
Gunakan akun layanan untuk mengautentikasi panggilan ke Subscription Linking API, baik dengan library klien googleapis maupun dengan menandatangani permintaan dengan REST API. Library klien otomatis menangani permintaan access_token
yang sesuai, sedangkan REST API memerlukan pengambilan id_token
, lalu menukarnya dengan access_token
.
Library klien dan contoh REST API berikut menggunakan endpoint getReader()
. Untuk menunjukkan
semua metode API secara langsung, lihat situs
Demo Penautan Langganan, atau kodenya.
Contoh permintaan dengan library klien googleapis node.js
import {readerrevenuesubscriptionlinking_v1, Auth} from 'googleapis'
const subscriptionLinking = readerrevenuesubscriptionlinking_v1.Readerrevenuesubscriptionlinking
class SubscriptionLinking {
constructor() {
this.auth = new Auth.GoogleAuth({
keyFile: process.env.KEY_FILE,
scopes: [
'https://www.googleapis.com/auth/readerrevenue.subscriptionlinking.manage'
],
})
}
init() {
return new subscriptionLinking(
{version: 'v1', auth: this.auth})
}
}
const api = new SubscriptionLinking()
const client = api.init()
async function getReader (ppid) {
const publicationId = process.env.PUBLICATION_ID
return await client.publications.readers.get({
name: `publications/${publicationId}/readers/${ppid}`,
})
}
Menandatangani permintaan REST API secara manual
import fetch from 'node-fetch'
import jwt from 'jsonwebtoken'
function getSignedJwt() {
/*
Either store the credentials string in an environmental variable
Or implement logic to fetch it.
*/
const key_file = process.env.CREDENTIALS_STRING
const issueDate = new Date()
const expireMinutes = 60
const offsetInSeconds = issueDate.getTimezoneOffset() * 60000
const expireDate = new Date(issueDate.getTime() + (expireMinutes * 60000))
const iat = Math.floor((issueDate.getTime() + offsetInSeconds) / 1000)
const exp = Math.floor((expireDate.getTime() + offsetInSeconds) / 1000)
const token = {
iss: key_file.client_email,
iat,
exp,
aud: 'https://oauth2.googleapis.com/token',
scope:'https://www.googleapis.com/auth/readerrevenue.subscriptionlinking.manage',
}
return jwt.sign(token, key_file.private_key, {
algorithm: 'RS256',
keyid: key_file.private_key_id,
})
}
async function getAccessToken(signedJwt) {
let body = new URLSearchParams();
body.set('grant_type', 'urn:ietf:params:oauth:grant-type:jwt-bearer')
body.set('assertion', signedJwt)
const request = await fetch('https://oauth2.googleapis.com/token', {
method: 'POST',
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body
})
const accessResponse = await accessFetch.json()
return accessResponse.access_token
}
async function getReader(ppid) {
const publicationId = process.env.PUBLICATION_ID
const base_url = 'https://readerrevenuesubscriptionlinking.googleapis.com/v1'
const endpoint = `${base_url}/publications/${publicationId}/readers/${ppid}`
const signedJwt = await getSignedJwt()
const accessToken = await getAccessToken(signedJwt)
const reader = await fetch(endpoint, {
method: 'GET',
headers: {
Authorization: `Bearer ${accessToken}`,
},
}).then((response) => {
return response.json()
})
return reader
}