임시 ID 사용

BatchJobService의 강력한 기능은 임시 ID 사용을 지원합니다.

이렇게 하려면 새 리소스의 resource_name를 제외 ID입니다. 예를 들어 캠페인을 만들고 리소스 이름을 지정하는 경우 customers/<YOUR_CUSTOMER_ID>/campaigns/-1로 설정한 경우 해당 리소스 이름으로 리소스를 참조할 수 있으며 지정한 -1가 생성된 캠페인의 실제 ID로 대체됩니다. 자동으로 확장 및 축소할 수 있습니다

임시 리소스 이름을 사용할 때 유의해야 할 사항은 다음과 같습니다.

  • 임시 리소스 이름은 리소스도 제공합니다 아래의 예에서는 광고그룹 작업이 를 입력합니다.
  • 임시 리소스 이름은 작업 또는 변경 요청에서 저장되지 않습니다. 이전 작업이나 변경 요청에서 생성된 리소스를 참조하려면 이름을 지정할 수 있습니다
  • 단일 작업 또는 변경 요청의 경우 각 임시 리소스 이름은 고유 음수 값(리소스 유형이 다른 경우도 해당)에 해당합니다. 만약 임시 ID가 단일 작업 또는 변경 요청에서 재사용되면 오류가 발생합니다. 반환됩니다.

위에 언급된 상황에 대한 좀 더 구체적인 예를 들어보자면, 캠페인, 광고그룹, 광고를 단일 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"
        ...
      }
    }
  },
]

광고 그룹에 다른 임시 ID를 재사용할 수 없기 때문에 캠페인에 사용한 -1이며, 다음 경우에도 이 광고그룹을 참조합니다. 광고그룹 광고를 만드는 과정입니다. 광고 그룹 자체는 앞서 지정한 리소스 이름을 요청된 작업이 캠페인에 대해 설정된 것으로 ad_group_ad_operationresource_name는 더 이상 필요하지 않으므로 필요하지 않습니다. 참조가 있는지 확인합니다