Google Ads API এনটিটি এবং রিপোর্টিং ডেটা পুনরুদ্ধার করতে, এই পদ্ধতিগুলোর মধ্যে একটি ব্যবহার করুন:
দুটি পদ্ধতির মধ্যে প্রধান পার্থক্যগুলো নিচে দেওয়া হলো:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| প্রোডাকশন কোডের জন্য উপযুক্ত | হ্যাঁ | হ্যাঁ |
| পরিষেবা | GoogleAdsService | GoogleAdsService |
| দৃশ্যকল্প | বস্তু এবং প্রতিবেদন আনা | বস্তু এবং প্রতিবেদন আনা |
| প্রতিক্রিয়া | GoogleAdsRow অবজেক্টের স্ট্রিম | GoogleAdsRow অবজেক্টের পৃষ্ঠাগুলি |
| প্রতিক্রিয়ার ক্ষেত্রগুলি | কোয়েরিতে শুধুমাত্র নির্দিষ্ট করাগুলো। | কোয়েরিতে শুধুমাত্র নির্দিষ্ট করাগুলো। |
| দৈনিক সীমা | অ্যাক্সেস স্তরের উপর ভিত্তি করে দৈনিক সীমা | অ্যাক্সেস স্তরের উপর ভিত্তি করে দৈনিক সীমা |
SearchStream বনাম Search
সম্পূর্ণ রিপোর্টটি ডাউনলোড করার জন্য Search একাধিক পৃষ্ঠাযুক্ত অনুরোধ পাঠাতে পারলেও, SearchStream রিপোর্টের আকার নির্বিশেষে একটিমাত্র অনুরোধ পাঠায় এবং গুগল অ্যাডস এপিআই-এর সাথে একটি স্থায়ী সংযোগ স্থাপন করে।
SearchStream এর ক্ষেত্রে, ডেটা প্যাকেটগুলো তাৎক্ষণিকভাবে ডাউনলোড হতে শুরু করে এবং সম্পূর্ণ ফলাফল একটি ডেটা বাফারে ক্যাশ করা থাকে। আপনার কোড পুরো স্ট্রিমটি শেষ হওয়ার জন্য অপেক্ষা না করেই বাফার করা ডেটা পড়া শুরু করতে পারে।
একটি Search রেসপন্সের প্রতিটি স্বতন্ত্র পেজ অনুরোধ করার জন্য প্রয়োজনীয় রাউন্ড-ট্রিপ নেটওয়ার্ক টাইম বাদ দেওয়ার মাধ্যমে, আপনার অ্যাপের ওপর নির্ভর করে, SearchStream পেজিংয়ের চেয়ে উন্নত পারফরম্যান্স দিতে পারে, বিশেষ করে বড় রিপোর্টের ক্ষেত্রে।
উদাহরণ
এই উদাহরণে 100,000 সারি সম্বলিত একটি প্রতিবেদন আলোচনা করা হয়েছে। নিচের সারণিতে দুটি পদ্ধতির মধ্যে হিসাবরক্ষণের পার্থক্যগুলো বিশদভাবে তুলে ধরা হয়েছে।
| সার্চস্ট্রিম | অনুসন্ধান | |
|---|---|---|
| পৃষ্ঠার আকার | প্রযোজ্য নয় | প্রতি পৃষ্ঠায় ১০,০০০ সারি |
| এপিআই অনুরোধের সংখ্যা | ১টি অনুরোধ | ১০টি অনুরোধ |
| এপিআই প্রতিক্রিয়ার সংখ্যা | ১টি অবিচ্ছিন্ন প্রবাহ | ১০টি প্রতিক্রিয়া |
কর্মক্ষমতার কারণগুলি
বেশিরভাগ ব্যবহারের ক্ষেত্রে, আমরা নিম্নলিখিত কারণগুলির জন্য Search পরিবর্তে SearchStream ব্যবহারের সুপারিশ করি:
এক পৃষ্ঠার প্রতিবেদনের ক্ষেত্রে (১০,০০০-এর কম সারি): দুটি পদ্ধতির মধ্যে পারফরম্যান্সে কোনো উল্লেখযোগ্য পার্থক্য নেই।
একাধিক পৃষ্ঠার রিপোর্টের ক্ষেত্রে,
SearchStreamসাধারণত দ্রুততর হয়, কারণ এতে একাধিকবার ডেটা আদান-প্রদান এড়ানো যায় এবং ডিস্ক ক্যাশে থেকে পড়া বা লেখার বিষয়টি ততটা গুরুত্বপূর্ণ থাকে না।
হারের সীমা
উভয় পদ্ধতির জন্য দৈনিক সীমা আপনার ডেভেলপার টোকেনের সাধারণ সীমা এবং অ্যাক্সেস স্তর মেনে চলে। ফলাফল পেজড বা স্ট্রিমড যাই হোক না কেন, একটি একক কোয়েরি বা রিপোর্টকে একটি অপারেশন হিসাবে গণনা করা হয়।