WebhookNotification
যখন রিসোর্স আপডেট হয় তখন আপনার ওয়েবহুক সার্ভারে Google Analytics ডেটা API থেকে একটি ওয়েবহুক বিজ্ঞপ্তি পাঠাতে একটি দীর্ঘমেয়াদী অপারেশন রিসোর্স কনফিগার করে।
বিজ্ঞপ্তি কনফিগারেশন ব্যক্তিগত মান ধারণ করে এবং শুধুমাত্র আপনার GCP প্রকল্পের জন্য দৃশ্যমান। বিভিন্ন GCP প্রকল্প একই দীর্ঘ-চলমান অপারেশন রিসোর্সে বিভিন্ন ওয়েবহুক বিজ্ঞপ্তি সংযুক্ত করতে পারে।
| JSON প্রতিনিধিত্ব |
|---|
{
"uri": string,
"channelToken": string
} |
| ক্ষেত্র |
|---|
uri | string ঐচ্ছিক। যে ওয়েব ঠিকানাটি ওয়েবহুক বিজ্ঞপ্তি পাবে। এই ঠিকানাটি POST অনুরোধগুলি গ্রহণ করবে কারণ দীর্ঘস্থায়ী অপারেশন রিসোর্সের পরিবর্তন হবে৷ POST অনুরোধে শরীরে দীর্ঘ সময় ধরে চলমান অপারেশন রিসোর্সের JSON সংস্করণ এবং একটি sentTimestamp ক্ষেত্র উভয়ই থাকবে। প্রেরিত টাইমস্ট্যাম্প অনুরোধটি পাঠানোর যুগ থেকে ইউনিক্স মাইক্রোসেকেন্ড নির্দিষ্ট করবে; এটি আপনাকে পুনরায় প্লে করা বিজ্ঞপ্তিগুলি সনাক্ত করতে দেয়। একটি উদাহরণ URI হল https://us-central1-example-project-id.cloudfunctions.net/example-function-1 । URI অবশ্যই HTTPS ব্যবহার করবে এবং ওয়েব সার্ভারে একটি বৈধ SSL শংসাপত্র সহ একটি সাইটে নির্দেশ করবে৷ URI-তে অবশ্যই সর্বোচ্চ 128 অক্ষরের স্ট্রিং দৈর্ঘ্য থাকতে হবে এবং শুধুমাত্র RFC 1738 থেকে অনুমোদিত তালিকাভুক্ত অক্ষর ব্যবহার করতে হবে। যখন আপনার ওয়েবহুক সার্ভার একটি বিজ্ঞপ্তি পায়, তখন এটি 5 সেকেন্ডের মধ্যে 200-এর একটি HTTP প্রতিক্রিয়া স্ট্যাটাস কোড সহ উত্তর দেবে বলে আশা করা হচ্ছে। ওয়েবহুক বিজ্ঞপ্তি ব্যবহার করার জন্য একটি URI প্রয়োজন৷ এই ওয়েবহুক সার্ভারের অনুরোধে একটি আইডি টোকেন থাকবে যা পরিষেবা অ্যাকাউন্ট google-analytics-audience-export@system.gserviceaccount.com এর প্রমাণীকরণ করবে। আইডি টোকেন সম্পর্কে আরও জানতে, https://cloud.google.com/docs/authentication/token-types#id দেখুন। Google ক্লাউড ফাংশনের জন্য, এটি আপনাকে প্রমাণীকরণের প্রয়োজনে আপনার ফাংশন কনফিগার করতে দেয়৷ ক্লাউড আইএএম-এ, আপনাকে Google ক্লাউড ফাংশন প্রমাণীকরণ পাস করার জন্য ওয়েবহুক পোস্টের অনুরোধের জন্য ক্লাউড রান ইনভোকার ( roles/run.invoker ) এবং ক্লাউড ফাংশন ইনভোকার ( roles/cloudfunctions.invoker ) ভূমিকাগুলিকে পরিষেবা অ্যাকাউন্টের অনুমতি দিতে হবে৷ এই API নির্বিচারে URI-তে ওয়েবহুক বিজ্ঞপ্তি পাঠাতে পারে; Google ক্লাউড ফাংশন ব্যতীত অন্য ওয়েবহুক সার্ভারগুলির জন্য, অনুমোদন বাহক শিরোনামে এই আইডি টোকেনটি উপেক্ষা করা উচিত যদি এটির প্রয়োজন না হয়৷ |
channelToken | string ঐচ্ছিক। চ্যানেল টোকেন একটি অবাধ স্ট্রিং মান এবং সর্বোচ্চ 64 অক্ষরের স্ট্রিং দৈর্ঘ্য থাকতে হবে। চ্যানেল টোকেন আপনাকে ওয়েবহুক বিজ্ঞপ্তির উৎস যাচাই করতে দেয়। এই বার্তাটি প্রতারণা করা থেকে রক্ষা করে। চ্যানেল টোকেন ওয়েবহুক POST অনুরোধের X-Goog-Channel-Token HTTP হেডারে নির্দিষ্ট করা হবে। ওয়েবহুক বিজ্ঞপ্তি ব্যবহার করার জন্য চ্যানেল টোকেনের প্রয়োজন নেই। |
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। Java হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-01-07 UTC-তে শেষবার আপডেট করা হয়েছে।
[null,null,["2025-01-07 UTC-তে শেষবার আপডেট করা হয়েছে।"],[[["Webhook notifications can be configured for long-running operations in the Google Analytics Data API to send updates to your server."],["These notifications are project-specific and include a JSON payload with operation details and a timestamp."],["The webhook configuration requires a URI using HTTPS with a valid SSL certificate, and optionally, a channel token for verification."],["When receiving a notification, your server should respond with an HTTP 200 status code within 5 seconds."],["Authentication for Google Cloud Functions is provided through an ID token representing the service account `google-analytics-audience-export@system.gserviceaccount.com`, while other webhook servers can ignore this token."]]],["This document outlines the configuration for webhook notifications from the Google Analytics Data API. You can set up a webhook server (`uri`) to receive POST requests containing long-running operation resource updates in JSON format, along with a `sentTimestamp`. The `uri` must be HTTPS with a valid SSL certificate and is required for webhook notifications. Optionally, use a `channelToken` for source verification, which is included in the `X-Goog-Channel-Token` header. Notifications will include an ID token for authentication.\n"]]
