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 হেডারে নির্দিষ্ট করা হবে।

ওয়েবহুক বিজ্ঞপ্তি ব্যবহার করার জন্য চ্যানেল টোকেনের প্রয়োজন নেই।