Dengan menggunakan Video Stitcher API, Anda membuat sesi live setiap kali memulai pemutaran live stream yang iklannya digabungkan secara dinamis selama jeda iklan. Respons berisi URL pemutaran dan konfigurasi sesi live.
Halaman ini menjelaskan cara membuat dan mengelola sesi live yang tidak diaktifkan oleh Google Ad Manager. Untuk informasi selengkapnya tentang jenis sesi live ini, lihat Mengelola sesi live yang diaktifkan oleh Google Ad Manager.
Sebelum memulai
Membuat sesi live
Untuk membuat sesi live, gunakan
metode projects.locations.liveSessions.create
.
Saat Anda membuat sesi live, kolom berikut bersifat opsional:
adTagMacros
: daftar pasangan nilai kunci untuk penggantian makro tag iklan; lihat bagian makro tag iklanmanifestOptions
: menentukan render video yang dibuat dalam manifes video yang digabungkan dan urutan render; lihat dokumentasi opsi manifes
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: nomor project Google Cloud Anda yang terletak di kolom Project number di halaman IAM SettingsPROJECT_NUMBER
: lokasi tempat membuat sesi; gunakan salah satu region yang didukungLOCATION Menampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
: ID yang ditentukan pengguna untuk konfigurasi aktifLIVE_CONFIG_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)
Simpan isi permintaan dalam file bernama request.json
.
Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:
cat > request.json << 'EOF' { "liveConfig": "projects/PROJECT_NUMBER /locations/LOCATION /liveConfigs/LIVE_CONFIG_ID " } EOF
Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions"
PowerShell (Windows)
Simpan isi permintaan dalam file bernama request.json
.
Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:
@' { "liveConfig": "projects/PROJECT_NUMBER /locations/LOCATION /liveConfigs/LIVE_CONFIG_ID " } '@ | Out-File -FilePath request.json -Encoding utf8
Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID ", "playUri": "PLAY_URI ", "liveConfig": "projects/PROJECT_NUMBER /locations/LOCATION /liveConfigs/LIVE_CONFIG_ID ", }
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Responsnya adalah objek sesi live. playUri
adalah URL yang digunakan perangkat klien untuk memutar streaming iklan yang digabungkan untuk
sesi live ini.
Video Stitcher API menghasilkan ID sesi unik untuk setiap permintaan. Sesi akan berakhir jika playUri
tidak diminta dalam 5 menit terakhir.
Iklan harus dienkode sebelum dapat digabungkan ke sesi live. Saat Anda membuat sesi untuk video yang digabungkan dengan iklan, Video Stitcher API akan menentukan apakah iklan telah dienkode dari sesi sebelumnya. API hanya mencari iklan yang dienkode yang dibuat oleh sesi yang terkait dengan project Google Cloud Anda. Untuk informasi selengkapnya tentang proses ini, lihat Ringkasan.
Jika membuat sesi atas nama perangkat pelanggan, Anda dapat menetapkan parameter berikut menggunakan header HTTP:
Parameter | Header HTTP |
---|---|
CLIENT_IP |
x-forwarded-for |
REFERRER_URL |
referer |
USER_AGENT |
user-agent |
Anda dapat menambahkan header berikut ke permintaan curl
sebelumnya:
-H "x-forwarded-for:CLIENT_IP " \ -H "referer:REFERRER_URL " \ -H "user-agent:USER_AGENT " \
Jika header x-forwarded-for
tidak diberikan, Video Stitcher API akan menggunakan alamat IP klien dalam permintaan metadata iklan. Perhatikan bahwa alamat IP klien
mungkin tidak cocok dengan IP perangkat pelanggan Anda jika sesi
dibuat atas nama perangkat pelanggan Anda.
Makro tag iklan
Tag iklan dapat berisi makro, yang dapat menghasilkan tag iklan yang berbeda untuk setiap sesi. Makro dilambangkan dengan tanda kurung siku di tag iklan, seperti yang diilustrasikan oleh contoh berikut:
AD_TAG_URI ¯o=[my-key]
adTagUri
ditentukan dalam konfigurasi live.
Untuk mengganti nilai dalam makro tag iklan, berikan pemetaan di
kolom adTagMacros
. Misalnya, jika ingin mengganti makro [my-key]
dengan string my-value
, Anda harus memberikan hal berikut:
{ ... "adTagMacros": { "my-key": "my-value" }, ... }
Saat meminta metadata iklan, Video Stitcher API menggunakan tag iklan berikut:
AD_TAG_URI ¯o=my-value
Mendapatkan sesi
Untuk mendapatkan sesi live, gunakan
metode projects.locations.liveSessions.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: nomor project Google Cloud Anda yang terletak di kolom Project number di halaman IAM SettingsPROJECT_NUMBER
: lokasi tempat membuat sesi; gunakan salah satu region yang didukungLOCATION Menampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
: ID untuk sesi liveSESSION_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID "
PowerShell (Windows)
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID " | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID ", "playUri": "ad-stitched-live-stream-uri ", "liveConfig": "projects/PROJECT_NUMBER /locations/LOCATION /liveConfigs/LIVE_CONFIG_ID ", }
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh playlist yang digabungkan dengan iklan
Berikut adalah contoh playlist live sumber sebelum penyambungan iklan:
#EXTM3U
#EXT-X-TARGETDURATION:10
#EXT-X-VERSION:4
#EXT-X-MEDIA-SEQUENCE:5
#EXTINF:10.010
segment_00005.ts
#EXTINF:10.010
segment_00006.ts
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2021-06-22T08:32:00Z",DURATION=60,SCTE35-OUT=0xF...
#EXTINF:10.010
segment_00007.ts
#EXTINF:10.010
segment_00008.ts
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2021-06-22T08:39:20Z",SCTE35-IN=0xF...
#EXTINF:10.010
segment_00009.ts
Berikut adalah contoh playlist live sumber setelah penyambungan iklan:
#EXTM3U
#EXT-X-TARGETDURATION:10
#EXT-X-VERSION:4
#EXT-X-MEDIA-SEQUENCE:5
#EXTINF:10.010
segment_00005.ts
#EXTINF:10.010
segment_00006.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000
https://ads.us-west1.cdn.videostitcher.goog/ad-1/seg-1.ts
#EXTINF:5.000
https://ads.us-west1.cdn.videostitcher.goog/ad-1/seg-2.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000
https://ads.us-west1.cdn.videostitcher.goog/ad-2/seg-1.ts
#EXTINF:5.000
https://ads.us-west1.cdn.videostitcher.goog/ad-2/seg-2.ts
#EXT-X-DISCONTINUITY
#EXTINF:10.010
segment_00009.ts
Menangani pelacakan iklan sisi klien
Saat pelacakan iklan klien diaktifkan, pemutar bertanggung jawab untuk memicu peristiwa pelacakan iklan. Metadata iklan yang disediakan oleh Video Stitcher API mencakup informasi iklan pengiring dan pelacakan iklan. Video Stitcher API mengurai informasi ini dari respons tag iklan.
Mendapatkan URI metadata iklan HLS dari manifes
Dalam manifes rendering HLS, AdMetadataURI
dienkode dalam atribut
X-VAST-META
dari tag #EXT-X-DATERANGE
. Tag #EXT-X-DATERANGE
dapat ditemukan
sebelum segmen pertama yang digabungkan dari setiap iklan.
Berikut adalah contoh tag metadata berwaktu HLS:
#EXT-X-DATERANGE:ID="id123",START-DATE=2014-03-05T11:15:00Z,DURATION=15,X-VAST-META="eyJBZE1ldGFkYXRhVXJpIjogImh0dHBzOi8vZXhhbXBsZS5jb20vdjFhbHBoYS9wcm9qZWN0cy8xMjMvbG9jYXRpb25zL3VzLWNlbnRyYWwxL2xpdmVTZXNzaW9ucy9hYmMzMjEvYWRNZXRhZGF0YS9pZDEyMyJ9"
Nilai atribut X-VAST-META
adalah string JSON yang dienkode base64. Setelah decode, Anda dapat mengekstrak AdMetadataURI
dari JSON.
Contoh berikut menunjukkan X-VAST-META
yang didekode:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
Mendapatkan URI metadata iklan DASH dari manifes
Dalam manifes DASH, setiap periode iklan yang dijahit berisi satu iklan VAST, dan URI metadata
iklannya dapat diekstrak dari dalam tag EventStream
. AdMetadataURI
dienkode dalam atribut messageData
dari elemen Event
. Event
adalah elemen di dalam tag EventStream
dengan schemeIdUri
dari urn:videostitcher:admetadata:202008
.
Berikut adalah contoh tag aliran data peristiwa DASH:
<EventStream schemeIdUri="urn:videostitcher:admetadata:202008" timescale="1000">
<Event duration="5000" messageData="eyJBZE1ldGFkYXRhVXJpIjogImh0dHBzOi8vZXhhbXBsZS5jb20vdjFhbHBoYS9wcm9qZWN0cy8xMjMvbG9jYXRpb25zL3VzLWNlbnRyYWwxL2xpdmVTZXNzaW9ucy9hYmMzMjEvYWRNZXRhZGF0YS9pZDEyMyJ9"></Event>
</EventStream>
Gunakan base64 untuk mendekode messageData
menjadi JSON.
Contoh berikut menunjukkan messageData
yang didekode:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
Mengambil dan memproses peristiwa tracking iklan
Setelah mendapatkan AdMetadataURI
, Anda dapat mengambil metadata iklan.
Contoh berikut menunjukkan metadata iklan:
{
"activityEvents": [
{
"type": "PAUSE",
"uri": "https://example.com/pause"
}
],
"progressiveEvents": [
{
"timeOffset": "0s",
"events": [
{
"type": "IMPRESSION",
"uri": "https://example.com/impression"
},
{
"type": "START",
"uri": "https://example.com/start"
}
]
},
{
"timeOffset": "2.500s",
"events": [
{
"type": "FIRST_QUARTILE",
"uri": "https://example.com/firstquartile"
}
]
}
],
"adDuration": "10s"
}
Dalam contoh sebelumnya, klien harus melakukan hal berikut:
- Meminta
https://example.com/start
di awal video iklan - Meminta
https://example.com/impression
di awal video iklan - Meminta
https://example.com/pause
setiap kali penonton menjeda video iklan - Minta
https://example.com/firstQuartile
2,5 detik setelah video iklan dimulai
Memeriksa sesi live
Bagian ini menjelaskan cara memeriksa sesi live dan detail tag iklan untuk sesi live tertentu. Untuk detail selengkapnya, lihat dokumentasi REST.
Video Stitcher API mengirim permintaan ke penyedia iklan yang ditentukan dalam tag iklan dalam isi permintaan sesi live. Metadata permintaan dan respons untuk permintaan ini disimpan selama 14 hari dan dapat dilihat dengan memeriksa sesi live.
Video Stitcher API menyusun detail tag iklan menggunakan hal berikut:
- URL tag iklan yang diminta dalam jeda iklan tertentu (atau tag iklan default jika tidak ada yang ditentukan)
- Makro tag iklan yang dikonfigurasi dari permintaan sesi live
- Metadata pengguna tambahan
Informasi ini, beserta isi dan metadata respons, memberikan insight tentang perilaku Video Stitcher API.
Mencantumkan detail tag iklan
Untuk mencantumkan detail tag iklan untuk sesi live, gunakan
metode
projects.locations.liveSessions.liveAdTagDetails.list
.
Pertimbangkan respons berikut untuk sesi live yang dibuat sebelumnya (beberapa kolom dihilangkan):
{ "name": "projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID ", ... }
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: nomor project Google Cloud Anda yang terletak di kolom Project number di halaman IAM SettingsPROJECT_NUMBER
: lokasi sesi Anda; gunakan salah satu wilayah yang didukungLOCATION Menampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
: ID untuk sesi liveSESSION_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails"
PowerShell (Windows)
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "liveAdTagDetails" : [ { "name": "projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID ", "adRequests": [ { "uri": "REQUEST_URL ", "requestMetadata": "AD_TAG_REQUEST_METADATA ", "responseMetadata": "AD_TAG_RESPONSE_METADATA " } ] } ] }
Salin LIVE_AD_TAG_DETAILS_ID
yang ditampilkan. Anda memerlukannya untuk
mendapatkan detail untuk satu tag iklan.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mendapatkan detail tag iklan
Untuk mendapatkan detail untuk satu detail tag iklan dalam sesi live, gunakan metode
projects.locations.liveSessions.liveAdTagDetails.get
.
Contoh berikut menunjukkan cara melihat satu detail tag iklan untuk sesi live menggunakan nama detail tag iklan yang ditampilkan dari permintaan sebelumnya:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: nomor project Google Cloud Anda yang terletak di kolom Project number di halaman IAM SettingsPROJECT_NUMBER
: lokasi sesi Anda; gunakan salah satu wilayah yang didukungLOCATION Menampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
: ID untuk sesi liveSESSION_ID
: ID untuk detail tag iklan aktifLIVE_AD_TAG_DETAILS_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID "
PowerShell (Windows)
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID " | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER /locations/LOCATION /liveSessions/SESSION_ID /liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID ", "adRequests": [ { "uri": "REQUEST_URL ", "requestMetadata": "AD_TAG_REQUEST_METADATA ", "responseMetadata": "AD_TAG_RESPONSE_METADATA " } ] }
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.