এই বিভাগটি সেইসব উন্নত ব্যবহারকারীদের জন্য যারা আগে থেকেই OAuth 2.0 স্পেসিফিকেশন সম্পর্কে পরিচিত এবং Google API-এর সাথে OAuth 2.0 ব্যবহার করার পদ্ধতি জানেন।
সুযোগ
একটি অ্যাক্সেস টোকেন একাধিক API-তে বিভিন্ন মাত্রার অ্যাক্সেস দিতে পারে। scope
নামের একটি পরিবর্তনশীল প্যারামিটার রিসোর্স ও অপারেশনের সেট নিয়ন্ত্রণ করে
যা অ্যাক্সেস টোকেন অনুমোদন করে। অ্যাক্সেস টোকেনের অনুরোধ করার সময়, আপনার অ্যাপ
scope প্যারামিটারে এক বা একাধিক ভ্যালু পাঠায়।
Google Ads API-এর স্কোপ হল:
https://www.googleapis.com/auth/adwords
অফলাইন অ্যাক্সেস ও টোকেনের লাইফটাইম
Google Ads API ক্লায়েন্ট অ্যাপের অফলাইন অ্যাক্সেসের অনুরোধ করা সাধারণ ব্যাপার। যেমন, আপনার ব্যবহারকারী যখন আপনার ওয়েবসাইট ব্রাউজ করছেন না, অর্থাৎ ফিজিক্যালি অনলাইন নেই, তখন আপনার অ্যাপ ব্যাচ জব রান করতে চাইতে পারে। অ্যাক্সেস টোকেনের মেয়াদ ৩৬০০ সেকেন্ড (১ ঘণ্টা) থাকে, এর পরে আপনার অ্যাপকে নতুন অ্যাক্সেস টোকেনের জন্য রিফ্রেশ টোকেন এক্সচেঞ্জ করতে হবে।
ওয়েব অ্যাপের জন্য অফলাইন অ্যাক্সেসের অনুরোধ করতে, নিশ্চিত করুন যে আপনি
access_type প্যারামিটারকে offline হিসেবে সেট করেছেন। আপনি
Google-এর OAuth 2.0 নির্দেশিকা থেকে অতিরিক্ত তথ্য পেতে পারেন।
ডেস্কটপ অ্যাপের ক্ষেত্রে, অফলাইন অ্যাক্সেস ডিফল্ট হিসেবে চালু থাকে—আপনাকে এর জন্য আলাদা করে অনুরোধ করতে হবে না।
রিকোয়েস্ট হেডার
Google Ads API-তে করা সব অনুরোধের রিকোয়েস্ট হেডারে OAuth 2.0 অ্যাক্সেস টোকেন থাকতেই হবে। gRPC এবং REST ব্যবহার করে কীভাবে এইসব ক্রেডেনশিয়াল পাস করতে হয় তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।
gRPC হেডার
gRPC API ব্যবহার করার সময়, প্রতিটি অনুরোধে অ্যাক্সেস টোকেন অন্তর্ভুক্ত করুন। আপনি
একটি Credential-কে একটি Channel-এর সাথে বাইন্ড করতে পারেন যাতে সেই চ্যানেলের সব অনুরোধে ব্যবহার করা যায়। এছাড়াও, আপনি
প্রতিটি কলের জন্য কাস্টমাইজ করা ক্রেডেনশিয়াল পাঠাতে পারবেন। অনুমোদন ম্যানেজ করা সম্পর্কে আরও বিবরণ gRPC অনুমোদন
নির্দেশিকা থেকে জানতে পারবেন।
REST হেডার
REST API ব্যবহার করার সময়, HTTP হেডার
Authorization: Bearer <ACCESS_TOKEN>-এর মাধ্যমে অ্যাক্সেস টোকেন পাস করুন। HTTP অনুরোধের একটি উদাহরণ দেখানো হয়েছে:
# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
# API_VERSION,
# OAUTH2_ACCESS_TOKEN:
# See https://developers.google.com/google-ads/api/rest/auth#request_headers
# for details.
#
curl -f --request GET \
"https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \