Azure Data Factory 또는 Synapse Analytics를 사용하여 Google AdWords에서 데이터 복사

적용 대상: Azure Data Factory Azure Synapse Analytics

이 문서에서는 Azure Data Factory 또는 Synapse Analytics 파이프라인에서 복사 작업을 사용하여 Google AdWords에서 데이터를 복사하는 방법을 간략하게 설명합니다. 이 문서는 복사 작업에 대한 일반적인 개요를 제공하는 복사 작업 개요 문서를 기반으로 합니다.

지원되는 기능

이 Google AdWords 커넥터는 다음 기능에 대해 지원됩니다.

지원되는 기능 IR
복사 작업(원본/-) ① ②
조회 작업 ① ②

① Azure 통합 런타임 ② 자체 호스팅 통합 런타임

원본/싱크로 지원되는 데이터 저장소 목록은 지원되는 데이터 저장소 표를 참조하세요.

이 서비스는 연결을 사용하기 위한 기본 제공 드라이버를 제공하므로 이 커넥터를 사용하여 드라이버를 수동으로 설치하지 않아도 됩니다.

시작

파이프라인에 복사 작업을 수행하려면 다음 도구 또는 SDK 중 하나를 사용하면 됩니다.

UI를 사용하여 Google AdWords에 연결된 서비스 만들기

다음 단계를 사용하여 Azure Portal UI에서 Google AdWords에 연결된 서비스를 만듭니다.

  1. Azure Data Factory 또는 Synapse 작업 영역에서 관리 탭으로 이동하여 연결된 서비스를 선택한 후 새로 만들기를 클릭합니다.

  2. Google을 검색하고 Google AdWords 커넥터를 선택합니다.

    Google AdWords 커넥터의 스크린샷

  3. 서비스 세부 정보를 구성하고, 연결을 테스트하고, 새로운 연결된 서비스를 만듭니다.

    Google AdWords에 연결된 서비스 구성의 스크린샷

커넥터 구성 세부 정보

다음 섹션에서는 Google 애드워즈 커넥터에 한정된 Data Factory 엔터티를 정의하는 데 사용되는 속성에 대해 자세히 설명합니다.

연결된 서비스 속성

중요

2022년 4월 27일까지 Google AdWords API의 종료로 인해 서비스가 새로운 Google Ads API로 업그레이드되었습니다. 자세한 마이그레이션 단계 및 권장 사항은 이 문서를 참조하세요. 2022년 4월 27일 이전에 마이그레이션을 수행해야 합니다.

다음은 Google 애드워즈 연결된 서비스에 대해 지원되는 속성입니다.

속성 Description 필수
type 형식 속성은 GoogleAdWords로 설정해야 합니다.
connectionProperties Google AdWords에 연결하는 방법을 정의하는 속성 그룹입니다.
connectionProperties에서:
clientCustomerID 보고서 데이터를 가져올 AdWords 계정의 클라이언트 고객 ID입니다.
loginCustomerID 특정 고객의 보고서 데이터를 가져오려는 Google AdWords 관리자 계정의 고객 ID입니다.
developerToken AdWords API에 대한 액세스 권한을 부여하는 데 사용하는 관리자 계정과 연관된 개발자 토큰입니다. 이 필드를 SecureString으로 표시하여 안전하게 저장하도록 선택하거나, Azure Key Vault에 암호를 저장하고 복사 작업이 데이터 복사를 수행할 때 거기에서 끌어오도록 할 수 있습니다. Key Vault에 자격 증명 저장에서 자세히 알아보세요.
authenticationType 인증에 사용되는 OAuth 2.0 인증 메커니즘입니다. ServiceAuthentication은 자체 호스팅 IR에서만 사용할 수 있습니다.
허용되는 값은 ServiceAuthentication, UserAuthentication입니다.
refreshToken UserAuthentication을 위한 애드워즈 액세스 권한을 부여하기 위해 Google에서 얻은 새로 고침 토큰입니다. 이 필드를 SecureString으로 표시하여 안전하게 저장하도록 선택하거나, Azure Key Vault에 암호를 저장하고 복사 작업이 데이터 복사를 수행할 때 거기에서 끌어오도록 할 수 있습니다. Key Vault에 자격 증명 저장에서 자세히 알아보세요.
clientId 새로 고침 토큰을 얻는 데 사용되는 Google 애플리케이션의 클라이언트 ID입니다. 이 필드를 SecureString으로 표시하여 안전하게 저장하도록 선택하거나, Azure Key Vault에 암호를 저장하고 복사 작업이 데이터 복사를 수행할 때 거기에서 끌어오도록 할 수 있습니다. Key Vault에 자격 증명 저장에서 자세히 알아보세요.
clientSecret 새로 고침 토큰을 얻는 데 사용되는 Google 애플리케이션의 클라이언트 암호입니다. 이 필드를 SecureString으로 표시하여 안전하게 저장하도록 선택하거나, Azure Key Vault에 암호를 저장하고 복사 작업이 데이터 복사를 수행할 때 거기에서 끌어오도록 할 수 있습니다. Key Vault에 자격 증명 저장에서 자세히 알아보세요.
이메일 ServiceAuthentication에 사용되는 서비스 계정 메일 ID이며 자체 호스팅 IR에서만 사용할 수 있습니다.
keyFilePath 서비스 계정 메일 주소를 인증하는 데 사용되는 .p12 또는 .json 키 파일의 전체 경로이며 자체 호스팅 IR에서만 사용할 수 있습니다.
trustedCertPath TLS를 통해 연결할 때 서버를 확인하는 데 사용되는 신뢰할 수 있는 CA 인증서를 포함하는 .pem 파일의 전체 경로입니다. 이 속성은 자체 호스팅 IR에서 TLS를 사용하는 경우에만 설정할 수 있습니다. 기본값은 IR과 함께 설치된 cacerts.pem 파일입니다.
useSystemTrustStore 시스템 신뢰 저장소 또는 지정된 PEM 파일의 CA 인증서를 사용할지 여부를 지정합니다. 기본값은 false입니다.

예:

{
    "name": "GoogleAdWordsLinkedService",
    "properties": {
        "type": "GoogleAdWords",
        "typeProperties": {
            "connectionProperties": {
                "clientCustomerID": "<clientCustomerID>",
                "loginCustomerID": "<loginCustomerID>",
                "developerToken": {
                    "type": "SecureString",
                    "value": "<developerToken>"
                },
                "authenticationType": "ServiceAuthentication",
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refreshToken>"
                },
                "clientId": {
                    "type": "SecureString",
                    "value": "<clientId>"
                },
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                },
                "email": "<email>",
                "keyFilePath": "<keyFilePath>",
                "trustedCertPath": "<trustedCertPath>",
                "useSystemTrustStore": true,
            }
        }
    }
}

데이터 세트 속성

데이터 세트 정의에 사용할 수 있는 섹션 및 속성의 전체 목록은 데이터 세트 문서를 참조하세요. 이 섹션에서는 Google 애드워즈 데이터 세트에서 지원하는 속성의 목록을 제공합니다.

Google 애드워즈에서 데이터를 복사하려면 데이터 세트의 형식 속성을 GoogleAdWordsObject로 설정합니다. 다음과 같은 속성이 지원됩니다.

속성 Description 필수
type 데이터 세트의 형태 속성을 GoogleAdWordsObject로 설정해야 합니다.
tableName 테이블 이름입니다. 아니요(작업 원본에서 "query"가 지정된 경우)

예제

{
    "name": "GoogleAdWordsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAdWords linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

복사 작업 속성

작업 정의에 사용할 수 있는 섹션 및 속성의 전체 목록은 파이프라인 문서를 참조하세요. 이 섹션에서는 Google 애드워즈 원본에서 지원하는 속성의 목록을 제공합니다.

Google 애드워즈를 원본으로

Google 애드워즈에서 데이터를 복사하려면 복사 작업의 원본 형식을 GoogleAdWordsSource로 설정합니다. 복사 작업 source 섹션에서 다음 속성이 지원됩니다.

속성 Description 필수
type 복사 작업 원본의 형식 속성은 GoogleAdWordsSource로 설정해야 합니다.
Query 사용자 지정 SQL 쿼리를 사용하여 데이터를 읽습니다. 예: "SELECT * FROM MyTable" 아니요(데이터 세트의 "tableName"이 지정된 경우)

예:

"activities":[
    {
        "name": "CopyFromGoogleAdWords",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<GoogleAdWords input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GoogleAdWordsSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

조회 작업 속성

속성에 대한 자세한 내용을 보려면 조회 작업을 확인하세요.

다음 단계

복사 작업에서 원본 및 싱크로 지원되는 데이터 저장소 목록은 지원되는 데이터 저장소를 참조하세요.