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