Уникальный идентификатор объекта в Google Ads API называется названием ресурса и представляет собой строку определенного формата. Если вы знаете идентификаторы компонентов объекта, то можете использовать утилиты клиентской библиотеки Java, чтобы сгенерировать или проанализировать полное название ресурса.
Как создавать названия ресурсов с помощью ResourceNames
Служебный класс ResourceNames создает название ресурса для объекта, если вам известны все идентификаторы, связанные с этим объектом. Например, название ресурса кампании имеет следующий формат:
customers/{customer_id}/campaigns/{campaign_id}
Если вы знаете идентификатор клиента (без дефисов) и идентификатор кампании, используйте класс ResourceNames, чтобы создать полное название ресурса, как показано ниже.
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Вы также можете создавать названия ресурсов для других типов объектов, которые принимают разные параметры идентификатора в зависимости от конечной формы названия ресурса.
Как анализировать названия ресурсов
Хотя класс ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) не зависит от версии API, клиентская библиотека Java также предоставляет строго типизированные классы названий ресурсов (например, CampaignName, AdGroupName и CustomerName) в каждом пакете ресурсов с версией (например, com.google.ads.googleads.v26.resources), которые позволяют преобразовать строку названия ресурса обратно в составляющие ее идентификаторы:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();