পোস্টমাস্টার টুলস API v2 তে মাইগ্রেট করুন

এই নির্দেশিকায় পোস্টমাস্টার টুলস এপিআই-এর v1 এবং v2-এর মধ্যে পার্থক্য এবং আপনার v1 অ্যাপ্লিকেশনটিকে v2-তে মাইগ্রেট করার পদ্ধতি বর্ণনা করা হয়েছে।

সংক্ষিপ্ত বিবরণ

পোস্টমাস্টার টুলস এপিআই-এর ভার্সন ২-এ বেশ কিছু নতুন ফিচার যোগ করা হয়েছে এবং ইমেইল পরিসংখ্যান সংগ্রহের জন্য বিদ্যমান কার্যকারিতাগুলোকে একত্রিত করা হয়েছে। v2-এর মাধ্যমে, আপনি এখন যা করতে পারবেন:

  • দৈনিকের পরিবর্তে তারিখের পরিসর অনুযায়ী পরিসংখ্যান সংগ্রহ করুন।
  • সেন্ডার পলিসি ফ্রেমওয়ার্ক (SPF), ডোমেইনকিজ আইডেন্টিফায়েড মেইল ​​(DKIM), এবং ডোমেইন-ভিত্তিক মেসেজ অথেন্টিকেশন, রিপোর্টিং অ্যান্ড কনফরমেন্স (DMARC)-এর কমপ্লায়েন্স স্ট্যাটাস সম্পর্কে অনুসন্ধান করুন।
  • একটিমাত্র এপিআই কলের মাধ্যমে একাধিক ডোমেইনের পরিসংখ্যান সংগ্রহ করুন।

প্রধান পরিবর্তনগুলোর মধ্যে রয়েছে:

  • trafficStats রিসোর্সটি domainStats দ্বারা প্রতিস্থাপিত হয়েছে।
  • domains.trafficStats.get এবং domains.trafficStats.list মেথডগুলোকে একটিমাত্র domains.domainStats.query মেথড দ্বারা প্রতিস্থাপন করা হয়েছে।
  • একটি নির্দিষ্ট ডোমেইনের জন্য SPF, DKIM, এবং DMARC-এর কমপ্লায়েন্স স্ট্যাটাস জানার জন্য domains.getComplianceStatus নামে একটি নতুন মেথড উপলব্ধ হয়েছে।
  • একই কলে একাধিক ডোমেইনের পরিসংখ্যান পাওয়ার জন্য domainStats.batchQuery নামে একটি নতুন মেথড উপলব্ধ হয়েছে।
  • v1-এ ব্যবহৃত 'মেট্রিক্স' পরিভাষাটির নাম পরিবর্তন করে 'স্ট্যাটিস্টিক্স' রাখা হয়েছে।

v2 তে আপডেট করুন

v1 থেকে v2-তে স্থানান্তরিত হতে হলে, আপনাকে আপনার ক্লায়েন্ট লাইব্রেরিটি সর্বশেষ সংস্করণে আপডেট করতে হবে এবং v2-এর রিসোর্স ও মেথড ব্যবহার করার জন্য আপনার কোড পরিবর্তন করতে হবে।

  1. আপনার পোস্টমাস্টার টুলস এপিআই ক্লায়েন্ট লাইব্রেরিটি সংস্করণ ২ বা তার উচ্চতর সংস্করণে আপডেট করুন।
  2. trafficStats রিসোর্স থেকে domainStats রিসোর্সে সমস্ত কল পরিবর্তন করুন।
  3. domains.trafficStats.get বা domains.trafficStats.list এর যেকোনো কলকে domains.domainStats.query দ্বারা প্রতিস্থাপন করুন এবং কোয়েরির জন্য তারিখের পরিসীমা নির্দিষ্ট করতে startDate ও endDate প্যারামিটার প্রদান করুন।

ইমেইল পরিসংখ্যান পুনরুদ্ধার করুন

v1-এ, ইমেল মেট্রিক্স একটি দিনের জন্য domains.trafficStats.get অথবা একাধিক দিনের জন্য domains.trafficStats.list ব্যবহার করে সংগ্রহ করা হতো। v2-এ, ইমেল পরিসংখ্যান domains.domainStats.query ব্যবহার করে সংগ্রহ করা হয়।

domains.domainStats.query মেথডটি আপনাকে startDate এবং endDate উল্লেখ করে একটি নির্দিষ্ট তারিখের পরিসরের পরিসংখ্যান পেতে সাহায্য করে।

v1: domains.trafficStats.get

জাভা 

String query = String.format("domains/%s/trafficStats/%s", domainName, date);
TrafficStats trafficStats = service.domains().trafficStats().get(query).execute();

পাইথন 

query = 'domains/%s/trafficStats/%s' %(domain_name,date)
traffic_stats = service.domains().trafficStats().get(name=query).execute();

v2: একটি নির্দিষ্ট দিনের জন্য domains.domainStats.query

v2-তে কোনো একটি নির্দিষ্ট দিনের পরিসংখ্যান পেতে, একই startDate এবং endDate ব্যবহার করে domains.domainStats.query কল করুন।

জাভা 

Date date = new Date().setYear(2024).setMonth(1).setDay(1);
QueryDomainStatsResponse statsResponse = service.domains().domainStats()
        .query("domains/" + domainName)
        .setStartDate(date)
        .setEndDate(date)
        .execute();

পাইথন 

date = {'year': 2024, 'month': 1, 'day': 1}
stats = service.domains().domainStats().query(
    parent='domains/' + domain_name,
    startDate=date,
    endDate=date).execute()

v1: domains.trafficStats.list

জাভা 

ListTrafficStatsResponse listTrafficStatsResponse = service.domains().trafficStats().list("domains/" + domainName)
        .execute();

পাইথন 

query = 'domains/' + domain_name
list_traffic_stats_response = service.domains().trafficStats().list(parent=query).execute();

v2: একটি তারিখের পরিসরের জন্য domains.domainStats.query

v2-তে একটি নির্দিষ্ট তারিখের পরিসরের পরিসংখ্যান পেতে, startDate এবং endDate সহ domains.domainStats.query কল করুন।

জাভা 

Date startDate = new Date().setYear(2024).setMonth(1).setDay(1);
Date endDate = new Date().setYear(2024).setMonth(1).setDay(7);
QueryDomainStatsResponse statsResponse = service.domains().domainStats()
        .query("domains/" + domainName)
        .setStartDate(startDate)
        .setEndDate(endDate)
        .execute();

পাইথন 

stats = service.domains().domainStats().query(
    parent='domains/' + domain_name,
    startDate={'year': 2024, 'month': 1, 'day': 1},
    endDate={'year': 2024, 'month': 1, 'day': 7}).execute()

নতুন v2 বৈশিষ্ট্য

get এবং list ট্র্যাফিক পরিসংখ্যানকে query একীভূত করার পাশাপাশি, v2 নিম্নলিখিত বৈশিষ্ট্যগুলি চালু করেছে।

সম্মতি স্থিতি পুনরুদ্ধার করুন

আপনি domains.getComplianceStatus ব্যবহার করে একটি ডোমেইনের জন্য Sender Policy Framework (SPF), DomainKeys Identified Mail (DKIM), এবং Domain-based Message Authentication, Reporting, and Conformance (DMARC)-এর কমপ্লায়েন্স স্ট্যাটাস জানতে পারেন।

নমুনা কোডের জন্য 'ইমেইল পরিসংখ্যান পুনরুদ্ধার' দেখুন।

ব্যাচ কোয়েরি ডোমেন পরিসংখ্যান

আপনি domainStats.batchQuery ব্যবহার করে একটিমাত্র কলে একাধিক ডোমেইনের পরিসংখ্যান পেতে পারেন।