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

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

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

পোস্টমাস্টার টুলস API-এর সংস্করণ ২ বেশ কিছু নতুন বৈশিষ্ট্য প্রবর্তন করে এবং ইমেল পরিসংখ্যান পুনরুদ্ধারের জন্য বিদ্যমান কার্যকারিতা একত্রিত করে। v2 এর মাধ্যমে, আপনি এখন যা করতে পারেন:

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

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

• 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 বৈশিষ্ট্য

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

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

আপনি domains.getComplianceStatus ব্যবহার করে একটি ডোমেনের জন্য প্রেরক নীতি ফ্রেমওয়ার্ক (SPF), DomainKeys Identified Mail (DKIM), এবং Domain-based Message Authentication, Reporting, and Conformance (DMARC) এর জন্য সম্মতি স্থিতি পুনরুদ্ধার করতে পারেন।

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

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

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