Google Ads Transparency Center API
Google 광고 투명성 센터는 Google 검색, YouTube, Google Play, 지도, 쇼핑에 게재된 인증 광고주의 광고를 보여줍니다. ads는 도메인이나 광고주 ID로 찾은 광고주 한 곳의 광고를 최대 100개 나열합니다.
advertiser에 lululemon.com 같은 도메인이나 AR로 시작하는 광고주 ID를 전달합니다. 광고는 대체로 최근 게재순으로 나열됩니다. 행에는 광고 문구, 지출액, 노출수가 없으며, 광고 소재를 보려면 url 또는 image_url을 엽니다. advertiser_name은 인증된 이름으로, 자회사나 대행사일 수 있습니다. Google 인증을 완료한 광고주만 표시됩니다.
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Google Ads Transparency Center 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
광고ads | advertiser 도메인이나 광고주 ID로 Google Ads 투명성 센터에서 기업이 Google에 게재한 광고를 최대 100개 나열합니다. | 요청 1,000개당 $0.68 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Google Ads Transparency Center 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
ads광고
| advertiser | country, end_date, format, start_date, surface | Sync 응답 | 카탈로그 값: defaultLimit=100, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.68 | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
Google Ads Transparency Center ads 파라미터는 각각 무엇을 의미하나요?
advertiser 도메인이나 광고주 ID로 Google Ads 투명성 센터에서 기업이 Google에 게재한 광고를 최대 100개 나열합니다. 각 행에는 광고 ID, 형식(텍스트, 이미지, 동영상), 최초 및 최종 게재 시간, 미리보기 이미지, 투명성 센터의 광고 링크가 포함됩니다. country, format, surface, 최초 게재일로 필터링할 수 있습니다. 지출과 노출 수는 포함되지 않습니다.
advertiser필수- 광고를 조회할 광고주입니다.
nike.com같은 도메인 또는 AR로 시작하는 광고주 ID(예:AR01614014350098432001)를 입력합니다. 광고 투명성 센터의 광고주 링크도 사용할 수 있습니다.내 광고 센터 도움말: 광고주 인증과 광고 투명성 센터 — Google 도움말 페이지에 따르면 광고주는 법적 서류로 신원을 인증해야 하며, 광고 투명성 센터에서는 광고주 이름이나 웹사이트로 검색하고 게재 지역과 날짜로 필터링할 수 있습니다. 이 자료는 도메인 또는 광고주로 검색하고 국가와 날짜로 필터링하는 방식을 뒷받침합니다. 이 API의 파라미터는 EveryInfra가 정의한 것이며, 이 자료는 결과를 보증하지 않습니다. · 확인일 country선택- 해당 국가에 게재된 광고만 남기는 두 글자 국가 코드입니다(예:
us,gb). 생략하면 전체 지역이 대상입니다. end_date선택- 이 날짜(YYYY-MM-DD) 당일 또는 이전에 처음 게재된 광고만 남깁니다.
start_date보다 앞설 수 없습니다. format선택- 한 가지 광고 형식만 남깁니다:
text,image,video.허용 값:imagetextvideo start_date선택- 이 날짜(YYYY-MM-DD) 당일 또는 이후에 처음 게재된 광고만 남깁니다.
surface선택- 특정 Google 제품에 게재된 광고만 남깁니다:
search,youtube,play,maps,shopping.
Google Ads Transparency Center API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Google Ads Transparency Center API 자주 묻는 질문
Google Ads Transparency Center API로 무엇을 가져올 수 있나요?
platform을 google_ads_transparency 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 광고입니다. 각 액션 이름은 서로 다른 Google Ads Transparency Center 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Google Ads Transparency Center ads 요청에는 어떤 입력이 필요한가요?
광고를 조회할 광고주입니다. nike.com 같은 도메인 또는 AR로 시작하는 광고주 ID(예: AR01614014350098432001)를 입력합니다. 광고 투명성 센터의 광고주 링크도 사용할 수 있습니다. params 안의 advertiser 필드로 전달하세요.
Google Ads Transparency Center ads 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 rank, ad_id, advertiser_id 및 advertiser_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Google Ads Transparency Center 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.