বিড ম্যানেজার API v1.1 থেকে v2 তে স্থানান্তর করুন

মার্চ 2022-এ, আমরা বিড ম্যানেজার API-এর সংস্করণ 2 প্রকাশ করেছি। এই নতুন সংস্করণের প্রকাশের প্রেক্ষিতে, আমরা শীঘ্রই v1.1-এর জন্য একটি সূর্যাস্তের তারিখ ঘোষণা করার পরিকল্পনা করছি। আমরা সুপারিশ করি যে আপনি যত তাড়াতাড়ি সম্ভব v1.1 থেকে v2 তে আপনার মাইগ্রেশন শুরু করুন৷

আপনার আবেদন স্থানান্তর করুন

v1.1 থেকে v2 তে স্থানান্তরিত করার জন্য v2 কল করার জন্য আপনার এন্ডপয়েন্ট URL গুলি আপডেট করতে হবে এবং পরিবর্তনগুলি ভাঙার জন্য অ্যাকাউন্টে আপনার অ্যাপ্লিকেশন আপডেট করতে হবে৷

v1.1 থেকে v2 তে আপনার API কলগুলি আপডেট করুন৷

v1.1 এর পরিবর্তে v2 ব্যবহার করতে, নতুন v2 এন্ডপয়েন্ট ব্যবহার করার জন্য আপনাকে আপনার অনুরোধ আপডেট করতে হবে।

সমতুল্য পদ্ধতি চিহ্নিত করুন

v1.1 থেকে v2 ব্যবহার করে আপনার API কলগুলি আপডেট করার জন্য, আপনাকে প্রথমে v2 এর সমতুল্য v1.1 পদ্ধতিগুলি সনাক্ত করতে হবে।

v1.1 এবং v2-এর মধ্যে সমস্ত পরিষেবা এবং পদ্ধতির নিম্নলিখিত নামগুলি সামান্য পরিবর্তিত হয়েছে:

নতুন শেষ পয়েন্টে আপডেট করুন

একবার আপনি সমতুল্য পদ্ধতি চিহ্নিত করলে, আপনাকে আপনার অনুরোধগুলি আপডেট করতে হবে। উদাহরণস্বরূপ, v1.1 এর সাথে queries.getquery পদ্ধতিতে কল করতে, আপনি নিম্নলিখিত URL ব্যবহার করবেন:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

queries.get নামে পরিচিত v2-তে সমতুল্য পদ্ধতিতে কল করতে, নিম্নলিখিতটিতে URL আপডেট করুন:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

আপনি যদি API-তে অনুরোধ করার জন্য একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে ক্লায়েন্ট লাইব্রেরির সবচেয়ে সাম্প্রতিক সংস্করণটি ব্যবহার করুন এবং v2 ব্যবহার করতে আপনার কনফিগারেশন আপডেট করুন।

প্রয়োজনীয় পরিবর্তন করুন

আমরা v2-তে বেশ কয়েকটি ব্রেকিং পরিবর্তন প্রবর্তন করছি। নিম্নলিখিত নির্দেশাবলী পর্যালোচনা করুন এবং বিড ম্যানেজার API-এর আপনার বিদ্যমান ব্যবহারের সাথে প্রাসঙ্গিক প্রয়োজনীয় পরিবর্তনগুলি করুন৷

queries সার্ভিসে কল আপডেট করুন

  • সাধারণ নেস্টেড অবজেক্ট দ্বারা উপস্থাপিত Query রিসোর্সে নিম্নলিখিত ক্ষেত্রগুলি নিম্নলিখিত অবজেক্টের ধরনগুলি ব্যবহার করতে পরিবর্তিত হয়েছে:
    v1.1 ক্ষেত্র সমতুল্য v2 অবজেক্ট টাইপ
    metadata QueryMetadata
    params Parameters
    params.options Options
    params.options.pathQueryOptions PathQueryOptions
    params.options.pathQueryOptions.channelGrouping ChannelGrouping
    params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[].eventFilters[].dimensionFilter PathQueryOptionsFilter
    params.options.pathQueryOptions.pathFilters[].eventFilters[].dimensionFilter PathQueryOptionsFilter
    schedule QuerySchedule
  • Query রিসোর্সে নিম্নলিখিত ক্ষেত্রগুলি মূলত সাধারণ তালিকা বস্তু দ্বারা উপস্থাপিত নিম্নলিখিত নতুন অবজেক্ট প্রকারের তালিকায় পরিবর্তিত হয়েছে:
    v1.1 তালিকা ক্ষেত্র v2 অবজেক্ট টাইপ
    params.filters[] FilterPair
    params.options.pathQueryOptions.channelGrouping.rules[] Rule
    params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[] DisjunctiveMatchStatement
    params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[].eventFilters[] EventFilter
    params.options.pathQueryOptions.pathFilters[] PathFilter
    params.options.pathQueryOptions.pathFilters[].eventFilters[] EventFilter
  • Query রিসোর্সে নিম্নলিখিত ক্ষেত্রগুলি, মূলত স্ট্রিং দ্বারা উপস্থাপিত, v2 তে enum প্রকার দ্বারা প্রতিনিধিত্ব করা হয় এবং নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত করে:
    • metadata.dataRange এর v2 সমতুল্য এখন Range enum ব্যবহার করে। এই enum-এ রূপান্তর করার সময়, PREVIOUS_HALF_MONTH মানটি সরানো হয়েছে এবং TYPE_NOT_SUPPORTED মানটি RANGE_UNSPECIFIED এ পরিবর্তিত হয়েছে।
    • metadata.format এখন Format enum ব্যবহার করে। এই enum-এ রূপান্তর করার সময়, মান EXCEL_CSV সরানো হয়েছে এবং মান FORMAT_UNSPECIFIED যোগ করা হয়েছে।
    • params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[].eventFilters[].dimensionFilter.match এবং params.options.pathQueryOptions.pathFilters[].eventFilters[].dimensionFilter.match এখন ব্যবহার করুন Match
    • params.options.pathQueryOptions.pathFilters[].pathMatchPosition এখন PathMatchPosition enum ব্যবহার করে। এই enum এ রূপান্তর করার সময়, মান PATH_MATCH_POSITION_UNSPECIFIED যোগ করা হয়েছে।
    • schedule.frequency এখন Frequency enum ব্যবহার করে। এই enum-এ রূপান্তর করার সময়, মান FREQUENCY_UNSPECIFIED যোগ করা হয়েছে।
    • params.type এখন ReportType enum ব্যবহার করে। এই enum এ রূপান্তর করার সময়, নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:
    • নিম্নলিখিত মানগুলিকে অবমূল্যায়ন করা হয়েছে:
      • TYPE_ACTIVE_GRP
      • TYPE_AUDIENCE_PERFORMANCE
      • TYPE_CLIENT_SAFE
      • TYPE_COMSCORE_VCE
      • TYPE_CROSS_FEE
      • TYPE_CROSS_PARTNER
      • TYPE_CROSS_PARTNER_THIRD_PARTY_DATA_PROVIDER
      • TYPE_ESTIMATED_CONVERSION
      • TYPE_FEE
      • TYPE_KEYWORD
      • TYPE_LINEAR_TV_SEARCH_LIFT
      • TYPE_NIELSEN_AUDIENCE_PROFILE
      • TYPE_NIELSEN_DAILY_REACH_BUILD
      • TYPE_NIELSEN_ONLINE_GLOBAL_MARKET
      • TYPE_PAGE_CATEGORY
      • TYPE_PETRA_NIELSEN_DAILY_REACH_BUILD
      • TYPE_PETRA_NIELSEN_ONLINE_GLOBAL_MARKET
      • TYPE_PIXEL_LOAD
      • TYPE_THIRD_PARTY_DATA_PROVIDER
      • TYPE_TRUEVIEW_IAR
      • TYPE_VERIFICATION
      • TYPE_YOUTUBE_VERTICAL
    • অবশিষ্ট মানগুলিকে UI-তে তাদের সমতুল্য মানগুলিকে আরও ভালভাবে প্রতিফলিত করতে আপডেট করা হয়েছে:
      v1.1 মান সমতুল্য ReportType মান
      TYPE_NOT_SUPPORTED REPORT_TYPE_UNSPECIFIED
      TYPE_GENERAL STANDARD
      TYPE_INVENTORY_AVAILABILITY INVENTORY_AVAILABILITY
      TYPE_AUDIENCE_COMPOSITION AUDIENCE_COMPOSITION
      TYPE_ORDER_ID FLOODLIGHT
      TYPE_TRUEVIEW YOUTUBE
      TYPE_NIELSEN_SITE GRP
      TYPE_PETRA_NIELSEN_AUDIENCE_PROFILE YOUTUBE_PROGRAMMATIC_GUARANTEED
      TYPE_REACH_AND_FREQUENCY REACH
      TYPE_REACH_AUDIENCE UNIQUE_REACH_AUDIENCE
      TYPE_PATH FULL_PATH
      TYPE_PATH_ATTRIBUTION PATH_ATTRIBUTION
  • ক্ষেত্রগুলি metadata.dataRange , reportDataStartTimeMs , এবং reportDataEndTimeMs ক্ষেত্র range , customStartDate , এবং customEndDate দিয়ে প্রতিস্থাপিত করা হয়েছে৷ ইউনিক্স যুগ থেকে নতুন তারিখ ক্ষেত্রগুলি মিলিসেকেন্ডের পরিবর্তে Date অবজেক্ট ব্যবহার করে। এই প্রতিস্থাপন ক্ষেত্রগুলি QueryMetadata অবজেক্টের dataRange ক্ষেত্রে নির্ধারিত DataRange অবজেক্টে সরানো হয়েছে।
  • QuerySchedule অবজেক্টে ক্ষেত্র schedule.startTimeMs এবং schedule.endTimeMs startDate এবং endDate ফিল্ড দিয়ে প্রতিস্থাপিত হয়েছে। ইউনিক্স যুগ থেকে নতুন তারিখ ক্ষেত্রগুলি মিলিসেকেন্ডের পরিবর্তে Date অবজেক্ট ব্যবহার করে।
  • ক্ষেত্রগুলি metadata.running , metadata.reportCount , metadata.googleCloudStoragePathForLatestReport , metadata.googleDrivePathForLatestReport , এবং metadata.latestReportRunTimeMs সরানো হয়েছে৷ একটি কোয়েরির সাম্প্রতিক জেনারেট হওয়া রিপোর্ট সম্পর্কিত তথ্য পরিবর্তে অনুরোধে সাম্প্রতিকতম প্রতিবেদনগুলিকে তালিকাভুক্ত করার নিশ্চয়তা দিতে “key.reportId desc”-এর orderBy ক্যোয়ারী প্যারামিটার সহ queries.reports.list পদ্ধতি ব্যবহার করে পুনরুদ্ধার করা উচিত।
  • ক্ষেত্র kind , timezoneCode , metadata.locale , params.includeInviteData , এবং schedule.nextRunMinuteOfDay সরানো হয়েছে৷
  • queries.create তৈরির পরে আর স্বয়ংক্রিয়ভাবে কোয়েরি চালায় না এবং asynchronous ক্যোয়ারী প্যারামিটার সরানো হয়েছে। নতুন প্রশ্নের জন্য রিপোর্ট তৈরি করতে queries.run এর পরে কল করুন queries.create
  • queries.run পদ্ধতিটি নিম্নলিখিত উপায়ে আপডেট করা হয়েছে:
    • asynchronous কোয়েরি প্যারামিটারটি synchronous কোয়েরি প্যারামিটার দিয়ে প্রতিস্থাপিত হয়েছে। নতুন ক্যোয়ারী প্যারামিটার ইনভার্স লজিক দিয়ে কাজ করে এবং নির্দিষ্ট না করলে মিথ্যা বলে বিবেচিত হয়। এটি প্রদত্ত, queries.run সিঙ্ক্রোনাসের বিপরীতে ডিফল্টভাবে v2 তে অসিঙ্ক্রোনাসভাবে রিপোর্ট তৈরি করে, যা v1.1-এ ডিফল্ট।
    • timezoneCode ক্ষেত্রটি সরাতে এবং dataRange , reportDataStartTimeMs , reportDataEndTimeMs ক্ষেত্রগুলিকে dataRange ক্ষেত্রে বরাদ্দ করা একটি DataRange অবজেক্টের সাথে প্রতিস্থাপন করতে অনুরোধের অংশটি আপডেট করা হয়েছে৷
    • পদ্ধতিটি একটি খালি প্রতিক্রিয়া বডির পরিবর্তে ফলাফল Report বস্তু প্রদান করে।
  • queries.list রেসপন্স বডিতে kind ক্ষেত্রটি সরানো হয়েছে।

reports পরিষেবাতে কল আপডেট করুন

ত্রুটি হ্যান্ডলিং যুক্তি আপডেট করুন

এপিআই জুড়ে ত্রুটি বার্তা v2 আপডেট করা হয়েছে. এই নতুন ত্রুটির বার্তাগুলি আরও সুনির্দিষ্ট এবং কিছু ক্ষেত্রে, API অনুরোধের মানগুলির তথ্য প্রদান করে যা ত্রুটিটি ফেরত দিতে পারে৷ যদি আপনার বিদ্যমান ত্রুটি হ্যান্ডলিং লজিক নির্দিষ্ট ত্রুটি বার্তা পাঠ্যের উপর নির্ভর করে, v2 এ স্থানান্তর করার আগে আপনার ত্রুটি পরিচালনার সাধারণীকরণ করুন।