এই বিভাগটি সেইসব উন্নত ব্যবহারকারীদের জন্য যারা আগে থেকেই 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 Authorization
গাইড-এ অনুমোদন ম্যানেজ করার ব্যাপারে আরও বিবরণ রয়েছে।
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}" \