Использование временных идентификаторов

Важной особенностью BatchJobService является поддержка использования временных идентификаторов.

Это можно сделать, указав resource_name нового ресурса, чтобы использовать отрицательный идентификатор. Например, предположим, что вы создаёте кампанию и указываете имя её ресурса как customers/<YOUR_CUSTOMER_ID>/campaigns/-1 . При последующем создании группы объявлений вы сможете ссылаться на неё по этому имени ресурса, и указанное вами -1 будет автоматически заменено фактическим идентификатором созданной кампании.

Вот несколько моментов, которые следует учитывать при использовании временных имен ресурсов:

• Имя временного ресурса можно использовать только после того, как оно определено в ресурсе. В следующем примере операция группы объявлений должна располагаться после операции кампании в списке операций.
• Временные имена ресурсов не запоминаются в заданиях и запросах на мутацию. Чтобы сослаться на ресурс, созданный в предыдущем задании или запросе на мутацию, используйте его фактическое имя.
• Для одного задания или запроса на мутацию имя каждого временного ресурса должно содержать уникальное отрицательное число, даже если они относятся к разным типам ресурсов. Если временный идентификатор повторно используется в одном задании или запросе на мутацию, возвращается ошибка.

Пример

Предположим, вы хотите добавить кампанию, группу объявлений и объявление в одном API-запросе. Для этого вам нужно создать структуру запроса, аналогичную следующей:

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

Для группы объявлений используется новый временный идентификатор, поскольку мы не можем повторно использовать значение -1 , которое мы использовали для кампании. Мы также ссылаемся на эту группу объявлений при создании объявления в группе объявлений. Сама группа объявлений ссылается на имя ресурса, которое мы установили для кампании в предыдущей операции запроса, при этом resource_name в ad_group_ad_operation не требуется, поскольку никакая последующая операция на него не ссылается.