Migracja do interfejsu Postmaster Tools API w wersji 2

W tym przewodniku opisujemy różnice między wersją 1 a 2 interfejsu Postmaster Tools API oraz sposób migracji aplikacji z wersji 1 do wersji 2.

Przegląd

Wersja 2 interfejsu Postmaster Tools API wprowadza kilka nowych funkcji i konsoliduje dotychczasowe funkcje pobierania statystyk e-maili. W wersji 2 możesz teraz:

  • pobierać statystyki za zakresy dat, a nie za poszczególne dni;
  • sprawdzać stan zgodności z SPF (Sender Policy Framework), DKIM (DomainKeys Identified Mail) i DMARC (Domain-based Message Authentication, Reporting, and Conformance);
  • pobierać statystyki dla wielu domen za pomocą jednego wywołania interfejsu API.

Najważniejsze zmiany:

  • Zasób trafficStats został zastąpiony zasobem domainStats.
  • Metody domains.trafficStats.get i domains.trafficStats.list zostały zastąpione jedną metodą domains.domainStats.query.
  • Dostępna jest nowa metoda domains.getComplianceStatus, która umożliwia pobieranie stanu zgodności z SPF, DKIM i DMARC w przypadku danej domeny.
  • Dostępna jest nowa metoda domainStats.batchQuery, która umożliwia pobieranie statystyk dla wielu domen za pomocą jednego wywołania.
  • Termin „dane” używany w wersji 1 został zmieniony na „statystyki”.

Aktualizacja do wersji 2

Aby przeprowadzić migrację z wersji 1 do wersji 2, musisz zaktualizować bibliotekę klienta do najnowszej wersji i zmodyfikować kod, aby używać zasobów i metod wersji 2.

  1. Zaktualizuj bibliotekę klienta interfejsu Postmaster Tools API do wersji 2 lub nowszej.
  2. Zmień wszystkie wywołania z zasobu trafficStats na zasób domainStats.
  3. Zastąp wszystkie wywołania domains.trafficStats.get lub domains.trafficStats.list wywołaniami domains.domainStats.query, podając parametry startDate i endDate, aby określić zakres dat zapytania.

Pobieranie statystyk e-maili

W wersji 1 dane e-maili były pobierane za pomocą metody domains.trafficStats.get w przypadku jednego dnia lub domains.trafficStats.list w przypadku wielu dni. W wersji 2 statystyki e-maili są pobierane za pomocą metody domains.domainStats.query.

Metoda domains.domainStats.query umożliwia pobieranie statystyk za zakres dat przez określenie parametrów startDate i endDate.

Wersja 1: domains.trafficStats.get

Java

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

Python

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

Wersja 2: domains.domainStats.query w przypadku jednego dnia

Aby pobrać statystyki za jeden dzień w wersji 2, wywołaj metodę domains.domainStats.query z tymi samymi parametrami startDate i endDate.

Java

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

Python

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

Wersja 1: domains.trafficStats.list

Java

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

Python

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

Wersja 2: domains.domainStats.query w przypadku zakresu dat

Aby pobrać statystyki za zakres dat w wersji 2, wywołaj metodę domains.domainStats.query z parametrami startDate i endDate.

Java

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();

Python

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

Nowe funkcje w wersji 2

Oprócz konsolidacji statystyk ruchu get i list w query wersja 2 wprowadza te funkcje:

Pobieranie stanu zgodności

Stan zgodności z SPF, DKIM i DMARC w przypadku domeny możesz pobrać za pomocą metody domains.getComplianceStatus.

Przykładowy kod znajdziesz w artykule Pobieranie stanu zgodności domeny.

Zbiorcze zapytanie o statystyki domeny

Statystyki dla wielu domen możesz pobrać za pomocą jednego wywołania metody domainStats.batchQuery.