Package google.mybusiness.performance.v1

সূচী

পারফরম্যান্সসার্ভিস

এই পরিষেবাটি ব্যবসায়ীদেরকে গুগলে তাদের ব্যবসায়িক প্রোফাইল সম্পর্কিত পারফরম্যান্স রিপোর্ট সংগ্রহ করার সুযোগ দেয়।

এপিআইটি aip.dev-এ পাওয়া নির্দেশিকাগুলো অনুসরণ করার চেষ্টা করে।

FetchMultiDailyMetricsTimeSeries

rpc FetchMultiDailyMetricsTimeSeries( FetchMultiDailyMetricsTimeSeriesRequest ) returns ( FetchMultiDailyMetricsTimeSeriesResponse )

একটি নির্দিষ্ট সময়সীমার প্রতিটি তারিখের জন্য এবং প্রযোজ্য ক্ষেত্রে, ঐচ্ছিকভাবে সাব-এনটিটি টাইপের জন্য সেই মানগুলি ফেরত দেয়, যা নির্দিষ্ট দৈনিক মেট্রিকগুলির সাথে সংশ্লিষ্ট।

অনুরোধের উদাহরণ: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/business.manage

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

GetDailyMetricsTimeSeries

rpc GetDailyMetricsTimeSeries( GetDailyMetricsTimeSeriesRequest ) returns ( GetDailyMetricsTimeSeriesResponse )

একটি নির্দিষ্ট দৈনিক মেট্রিকের সাথে সংশ্লিষ্ট, প্রদত্ত সময়সীমার প্রতিটি তারিখের মানগুলো ফেরত দেয়।

অনুরোধের উদাহরণ: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/business.manage

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

তালিকা অনুসন্ধান কীওয়ার্ড ইমপ্রেশন মাসিক

rpc ListSearchKeywordImpressionsMonthly( ListSearchKeywordImpressionsMonthlyRequest ) returns ( ListSearchKeywordImpressionsMonthlyResponse )

সার্চ বা ম্যাপে কোনো ব্যবসা খুঁজে পেতে ব্যবহৃত সার্চ কীওয়ার্ডগুলো ফেরত দেয়। প্রতিটি সার্চ কীওয়ার্ডের সাথে ইম্প্রেশনও থাকে, যা মাসিক ভিত্তিতে একত্রিত করা হয়।

অনুরোধের উদাহরণ: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/business.manage

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

ডেইলিমেট্রিক

একটি ব্যবসার জন্য উপলব্ধ সমস্ত দৈনিক মেট্রিক উপস্থাপন করে।

এনাম
DAILY_METRIC_UNKNOWN ডিফল্ট অজানা মানকে বোঝায়।
BUSINESS_IMPRESSIONS_DESKTOP_MAPS ডেস্কটপ ডিভাইসে গুগল ম্যাপস-এ ব্যবসায়িক ইম্প্রেশন। একজন অনন্য ব্যবহারকারীর দ্বারা একই দিনে একাধিক ইম্প্রেশনকে একটি একক ইম্প্রেশন হিসাবে গণনা করা হয়।
BUSINESS_IMPRESSIONS_MOBILE_MAPS মোবাইল ডিভাইসে গুগল ম্যাপস-এ ব্যবসায়িক ইম্প্রেশন। একজন অনন্য ব্যবহারকারীর দ্বারা একই দিনে একাধিক ইম্প্রেশনকে একটি একক ইম্প্রেশন হিসাবে গণনা করা হয়।
BUSINESS_CONVERSATIONS

ব্যবসায়িক প্রোফাইলে প্রাপ্ত বার্তা আদান-প্রদানের সংখ্যা।

BUSINESS_DIRECTION_REQUESTS ব্যবসায়িক অবস্থানে যাওয়ার জন্য যতবার দিকনির্দেশনার অনুরোধ করা হয়েছিল।
CALL_CLICKS বিজনেস প্রোফাইল কল বাটনটি যতবার ক্লিক করা হয়েছে।
WEBSITE_CLICKS ব্যবসায়িক প্রোফাইল ওয়েবসাইটটিতে যতবার ক্লিক করা হয়েছে।
BUSINESS_BOOKINGS রিজার্ভ উইথ গুগল-এর মাধ্যমে ব্যবসায়িক প্রোফাইল থেকে করা বুকিংয়ের সংখ্যা।
BUSINESS_FOOD_ORDERS

ব্যবসায়িক প্রোফাইল থেকে প্রাপ্ত খাবারের অর্ডারের সংখ্যা।

BUSINESS_FOOD_MENU_CLICKS ব্যবসায়িক প্রোফাইলের মেনু কন্টেন্ট দেখতে বা তার সাথে ইন্টারঅ্যাক্ট করতে করা ক্লিকের সংখ্যা। একজন স্বতন্ত্র ব্যবহারকারীর দ্বারা একই দিনে একাধিক ক্লিককে ১ হিসাবে গণনা করা হয়।

ডেইলিমেট্রিকটাইমসিরিজ

এটি একটি একক ডেটাপয়েন্টকে উপস্থাপন করে, যেখানে প্রতিটি ডেটাপয়েন্ট হলো একটি DailyMetric-DailySubEntityType-TimeSeries টাপল।

ক্ষেত্র
daily_metric

DailyMetric

যে DailyMetric-টি TimeSeries দ্বারা প্রতিনিধিত্ব করা হয়।

daily_sub_entity_type

DailySubEntityType

যে DailySubEntityType-টি TimeSeries-এর প্রতিনিধিত্ব করে। যখন ব্রেকডাউন বিদ্যমান থাকবে না, তখন এটিও উপস্থিত থাকবে না।

time_series

TimeSeries

ডেটাপয়েন্টগুলোর তালিকা, যেখানে প্রতিটি ডেটাপয়েন্ট হলো একটি তারিখ-মানের জোড়া।

ডেইলি রেঞ্জ

সময়সীমা বলতে তারিখের পরিসরকে বোঝানো হচ্ছে (উভয় তারিখ অন্তর্ভুক্ত)।

ক্ষেত্র
start_date

Date

আবশ্যক। অন্তর্ভুক্তিমূলক।

end_date

Date

আবশ্যক। অন্তর্ভুক্তিমূলক।

দৈনিক উপসত্তা প্রকার

DailyMetrics-এর সাথে সংশ্লিষ্ট সকল সম্ভাব্য উপ-সত্তা প্রকারকে উপস্থাপন করে।

ক্ষেত্র
ইউনিয়ন ফিল্ড Type । এটি বোঝায় যে নিম্নলিখিত প্রোটো ফিল্ডগুলির মধ্যে কেবল একটি অবশ্যই উপস্থিত থাকতে হবে। DailySubEntityType সব মেট্রিকের জন্য উপলব্ধ নয়। Type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
day_of_week

DayOfWeek

সপ্তাহের দিন নির্দেশ করে। যেমন: সোমবার। বর্তমানে সমর্থিত DailyMetrics = কোনোটিই নয়।

time_of_day

TimeOfDay

দিনের সময়কে ২৪-ঘণ্টার বিন্যাসে উপস্থাপন করে। যেমন: ১৩:৩৪:২০। বর্তমানে সমর্থিত DailyMetrics = NONE।

তারিখযুক্ত মান

এটি টাইমসিরিজের একটি একক ডেটাপয়েন্টকে উপস্থাপন করে, যেখানে প্রতিটি ডেটাপয়েন্ট হলো একটি তারিখ-মান জোড়া।

ক্ষেত্র
date

Date

যে তারিখটি ডেটাপয়েন্টটির সাথে সম্পর্কিত। দিনের ফিল্ডটি সেট করা না থাকলে এটি মাসের মান নির্দেশ করে।

value

int64

ডেটাপয়েন্টটির মান। মান শূন্য হলে এটি উপস্থিত থাকবে না।

FetchMultiDailyMetricsTimeSeriesRequest

এটি FetchMultiDailyMetricsTimeSeries-এর জন্য করা অনুরোধকে নির্দেশ করে।

ক্ষেত্র
location

string

আবশ্যক। যে অবস্থানের জন্য টাইম সিরিজটি সংগ্রহ করা হবে। ফরম্যাট: locations/{location_id} যেখানে location_id হলো একটি সুস্পষ্ট লিস্টিং আইডি।

daily_metrics[]

DailyMetric

প্রয়োজনীয়। যে মেট্রিকগুলোর টাইম সিরিজ পুনরুদ্ধার করতে হবে।

daily_range

DailyRange

প্রয়োজনীয়। যে সময়সীমার জন্য টাইম সিরিজটি সংগ্রহ করা হবে।

FetchMultiDailyMetricsTimeSeriesResponse

FetchMultiDailyMetricsTimeSeries-এর প্রতিক্রিয়া উপস্থাপন করে।

ক্ষেত্র
multi_daily_metric_time_series[]

MultiDailyMetricTimeSeries

ডেইলিমেট্রিক্স এবং তাদের সংশ্লিষ্ট টাইম সিরিজ।

GetDailyMetricsTimeSeriesRequest

এটি GetDailyMetricsTimeSeries-এর জন্য করা অনুরোধকে বোঝায়।

ক্ষেত্র
name

string

আবশ্যক। যে অবস্থানের জন্য টাইম সিরিজটি সংগ্রহ করা হবে। ফরম্যাট: locations/{location_id} যেখানে location_id হলো একটি সুস্পষ্ট লিস্টিং আইডি।

daily_metric

DailyMetric

প্রয়োজনীয়। সময় সিরিজ পুনরুদ্ধারের জন্য মেট্রিক।

daily_range

DailyRange

প্রয়োজনীয়। যে সময়সীমার জন্য টাইম সিরিজটি সংগ্রহ করা হবে।

daily_sub_entity_type

DailySubEntityType

ঐচ্ছিক। যে সাব-এনটিটি টাইপ এবং আইডির সাথে টাইম সিরিজটি সম্পর্কিত। বর্তমানে সমর্থিত DailyMetrics = NONE।

GetDailyMetricsTimeSeriesResponse

এটি GetDailyMetricsTimeSeries-এর প্রতিক্রিয়া উপস্থাপন করে।

ক্ষেত্র
time_series

TimeSeries

দৈনিক সময় সিরিজ।

ইনসাইটসভ্যালু

এটি একটি অন্তর্দৃষ্টিমূলক মানকে উপস্থাপন করে।

ক্ষেত্র
ইউনিয়ন ফিল্ড InsightsValue বোঝায় যে, নিম্নলিখিত প্রোটো ফিল্ডগুলোর মধ্যে কেবল একটি অবশ্যই উপস্থিত থাকতে হবে। InsightsValue নিম্নলিখিতগুলোর মধ্যে কেবল একটি হতে পারে:
value

int64

প্রকৃত মানকে বোঝায়।

threshold

int64

এটি সেই প্রান্তসীমা নির্দেশ করে যার নিচে প্রকৃত মানটি নেমে আসে।

ListSearchKeywordImpressionsMonthlyRequest

এটি ListSearchKeywordImpressionsMonthly-এর জন্য করা অনুরোধকে উপস্থাপন করে।

ক্ষেত্র
parent

string

আবশ্যক। যে অবস্থানের জন্য টাইম সিরিজটি সংগ্রহ করা হবে। ফরম্যাট: locations/{location_id} যেখানে location_id হলো একটি সুস্পষ্ট লিস্টিং আইডি।

monthly_range

MonthlyRange

প্রয়োজনীয়। যে মাসসীমার মধ্যে সার্চ কীওয়ার্ড ইম্প্রেশনগুলো একত্রিত করা হবে।

page_size

int32

ঐচ্ছিক। অনুরোধকৃত ফলাফলের সংখ্যা। ডিফল্ট পৃষ্ঠার আকার হলো ১০০। পৃষ্ঠার আকার সর্বোচ্চ ১০০ পর্যন্ত সেট করা যেতে পারে।

page_token

bytes

ঐচ্ছিক। পরবর্তী পৃষ্ঠাঙ্কিত ফলাফল নির্দেশকারী একটি টোকেন।

তালিকা অনুসন্ধান কীওয়ার্ড ইম্প্রেশন মাসিক প্রতিক্রিয়া

ListSearchKeywordImpressionsMonthly-এর প্রতিক্রিয়া উপস্থাপন করে।

ক্ষেত্র
search_keywords_counts[]

SearchKeywordCount

ব্যবসা খুঁজে পেতে ব্যবহৃত সার্চ টার্মগুলো।

next_page_token

bytes

ফেরত আসা সর্বশেষ পৃষ্ঠাঙ্কিত ফলাফল নির্দেশকারী একটি টোকেন। পরবর্তী অনুরোধগুলো কীওয়ার্ডের পরবর্তী "পৃষ্ঠা" পেতে এটি ব্যবহার করতে পারে। এটি কেবল তখনই উপস্থিত থাকবে যখন আরও ফলাফল ফেরত দেওয়ার থাকবে।

মাসিক পরিসর

সময়সীমা বলতে মাসব্যাপী একটি পরিসরকে বোঝানো হচ্ছে (উভয় মাস অন্তর্ভুক্ত)।

ক্ষেত্র
start_month

Date

আবশ্যক। অন্তর্ভুক্ত - শুধুমাত্র বছর এবং মাসের ক্ষেত্রগুলো বিবেচনা করা হবে।

end_month

Date

আবশ্যক। অন্তর্ভুক্ত - শুধুমাত্র বছর এবং মাসের ক্ষেত্রগুলো বিবেচনা করা হবে।

মাল্টিডেইলিমেট্রিকটাইমসিরিজ

DailyMetric, DailySubEntityType এবং TimeSeries-এর টাপলগুলোর একটি তালিকা উপস্থাপন করে।

ক্ষেত্র
daily_metric_time_series[]

DailyMetricTimeSeries

DailyMetric-TimeSeries জোড়াগুলোর তালিকা।

অনুসন্ধান কীওয়ার্ড সংখ্যা

একটি একক অনুসন্ধান কীওয়ার্ড এবং তার মানকে উপস্থাপন করে।

ক্ষেত্র
search_keyword

string

ব্যবহারকারী যে ছোট হাতের অক্ষরে স্ট্রিংটি প্রবেশ করিয়েছেন।

insights_value

InsightsValue

নিম্নলিখিত দুটির মধ্যে যেকোনো একটি: ১) অনুরোধ করা প্রতিটি মাসের জন্য একত্রিত, কোনো মাসে কীওয়ার্ডটি ব্যবহার করা স্বতন্ত্র ব্যবহারকারীর সংখ্যার যোগফল। ২) একটি থ্রেশহোল্ড যা নির্দেশ করে যে প্রকৃত মান এই থ্রেশহোল্ডের নিচে রয়েছে।

টাইমসিরিজ

এটি একটি সময়-ধারাকে উপস্থাপন করে।

ক্ষেত্র
dated_values[]

DatedValue

টাইমসিরিজের ডেটাপয়েন্টগুলোর তালিকা, যেখানে প্রতিটি ডেটাপয়েন্ট হলো একটি তারিখ-মানের জোড়া।