Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

인벤토리 뷰

개요

Actions Center의 인벤토리 뷰어를 사용하면 관심 장소 (POI) 오프라인 판매점 인벤토리의 처리 상태, 장소 일치 상태, 게재 자격 요건을 확인할 수 있습니다.

이 뷰어는 개별 처리와 관계없이 문제를 표시합니다. 즉, 발생할 수 있는 모든 오류 모드(정책, 경고, 오류 등)를 통합하는 각 서비스 제공업체의 활성 게재 상태를 나타내는 스테이트풀(Stateful) 문제입니다.

키워드 도구를 이용해 보십시오. 이 도구에서 처리할 수 있는 작업은 다음과 같습니다.

수집된 모든 서비스 제공업체와 실시간 제공 상태를 검색하고 검사합니다.
데이터 검증 오류 및 콘텐츠 정책 위반을 진단합니다.
정책 위반에 대한 이의신청을 제출하고 추적합니다.
서비스 제공업체 일치 진단을 검사하고 수동 일치 제안서를 제출합니다.
최신 피드 처리의 원시 JSON 페이로드를 검토합니다.

인벤토리 표 열

목록 보기에는 관심 장소 (POI) 피드에서 업로드된 모든 서비스 제공업체가 항목별로 계층적으로 정리되어 표시됩니다. 지역 관심 장소 ID, 일치 상태, 통합, 표시 경로로 필터링할 수 있습니다.

요약 표 열	설명
지역 관심 장소 ID	피드에 제공된 지역 숙박 시설의 고유 식별자 (`poi_id`)입니다.
현지 관심 장소 이름	피드에서 추출된 지역 숙박 시설의 현지화된 이름입니다.
일치 상태	관심 장소가 Google 지도 등록정보와 일치하는지 여부를 나타냅니다. • 예 (녹색 배지): Google 지도 장소와 일치합니다. • 아니요 (빨간색 배지): 일치하지 않음, 검토 또는 일치 제안이 필요합니다.
통합	지역 애그리게이터 단위 통합입니다.
Surface	타겟 게재 표시 경로 (예: 검색)입니다.
게재 상태	실시간 게재 가능 상태: • 사용 설정됨 (녹색 표시기): Google 표시 경로에 게재할 수 있고 활성 상태입니다. • 사용 중지됨 (빨간색 표시기): 유효성 검사 오류, 정책 위반 또는 일치하지 않는 상태로 인해 게재가 차단되었습니다.
오류	심각도가 오류인 활성 문제 수입니다. 숙박 시설에 오류가 있으면 해당 숙박 시설은 어떤 플랫폼에도 게재할 수 없습니다.
경고	심각도가 경고인 활성 문제 수입니다. 경고가 있는 속성은 계속 게재할 수 있습니다.
경기 정보	대화형 일치 수정 패널을 여는 일치 수정 버튼이 포함되어 있습니다.

관심 장소 세부정보 보기

목록 보기에서 관심 장소 ID를 클릭하면 항목의 전용 세부정보 페이지로 이동합니다.

세부정보 뷰는 확장 가능한 네 가지 섹션으로 구성됩니다.

1. 기본 정보

상위 수준 항목 메타데이터를 요약합니다.

관심 장소 이름: data[].name.localizations에서 파싱된 시설 이름입니다.
관심 장소 ID: 고유한 파트너 엔티티 식별자 (poi_id)입니다.
데이터 소스: 이 항목이 수집된 정확한 피드 파일 이름입니다.

2. 광고 현황

통합 및 타겟 표시 경로별로 게재 자격요건을 세분화합니다.

통합 및 표시 경로: 카테고리 및 타겟 표시 경로 (예: Search의 Local Aggregator Unit)
게재 상태: 현재 Enabled 또는 Disabled 상태입니다.
문제: 모든 활성 오류 또는 경고의 문제 배지를 표시합니다 (예: Unmatched entity, Policy Violation). 문제 배지를 클릭하면 문제 세부정보 패널이 열립니다.
이의신청: 재정의 또는 이의신청 상태 (Under review, Approved 또는 Rejected)를 표시합니다.

3. 일치 정보

장소 일치 진단을 표시합니다.

일치 입력: 피드에서 파싱된 형식화된 실제 주소(street_address, locality, region, postal_code, country)입니다.
일치 유형: 일치 해결 메커니즘 (예: Location)
일치 네임스페이스: 일치 변경사항이 적용되는 카테고리입니다 (예: Local Aggregator Unit).
일치 상태: Yes (녹색) 또는 No (빨간색)
일치 출력: 확인된 Google 지도 장소 이름, 주소, 장소 ID입니다.
일치 수정: 일치 제안 대화상자를 여는 버튼입니다.

4. 원시 JSON

빠른 스키마 디버깅 및 확인을 위해 전체 파싱된 JSON 페이로드 (item_proto)를 표시하는 줄 번호와 문법 강조 표시가 있는 대화형 코드 뷰어를 제공합니다. 여기에 표시된 데이터 값은 관심 장소 피드에서 수신된 값을 반영합니다.

문제 및 분류 워크플로

문제가 있는 것으로 신고된 항목은 사용 중지 (오류로 신고된 경우)되거나 성능이 저하 (경고로 신고된 경우)됩니다. 경고가 있는 항목 문제는 이의신청할 수 없으며 근본적인 문제를 해결하여 경고를 해결할 수 있습니다.

문제 유형: 이의신청 가능 여부

이의신청 불가 문제 (기술, 데이터 품질, 경고 검증):
- 스키마 오류, 필수 입력란 누락, 잘못된 좌표, 손상된 URL, 중복 ID 또는 비차단 콘텐츠 경고 (예: 기본이 아닌 언어의 비즈니스 이름 또는 설명, 표시 주소, 시설 카테고리의 언어)로 인해 발생합니다.
- 해결 방법: 파트너는 소스 피드의 기본 데이터를 수정하고 업데이트된 피드 파일을 업로드해야 합니다.
이의신청 가능한 문제 (콘텐츠 차단 및 정책 위반):
- 필수 속성 텍스트 또는 이미지 확장 소재가 ERROR 심각도로 자동 콘텐츠 안전 필터를 통과하지 못할 때 트리거됩니다.
- 해결 방법: 콘텐츠가 플랫폼 정책을 준수하는 경우 파트너는 Actions Center에서 문제 옆에 있는 이의신청 버튼을 클릭하여 이의신청을 제출할 수 있습니다. 파트너는 이유와 근거를 제공해야 하며, Google 이의신청팀에서 요청을 검토하고 승인하거나 거부합니다. 결정 사항은 도구와 이메일을 통해 알려드립니다.

지역 애그리게이터 단위 문제 카탈로그

다음 표에는 지역 애그리게이터 단위 통합에 대한 전체 유효성 검사 오류 및 정책 문제 코드가 나와 있습니다.

문제 설명	심각도	문제 코드	영향을 받는 필드 / 인수	이의신청이 가능한가요?	조치 / 관련 정책
POI ID 누락	ERROR	`MISSING_REQUIRED_FIELD`	`poi_id`	아니요	고유한 `poi_id`를 제공합니다. 관심 장소 피드 사양을 참고하세요.
'name' 필드의 기본 언어가 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`name.default_locale`	아니요	기본 언어에 유효한 BCP 47 언어 코드를 지정하세요. 다국어 지원을 참고하세요.
'name' 필드에 기본 현지화가 없습니다.	ERROR	`MISSING_REQUIRED_FIELD`	`name.localizations`	아니요	선언된 `default_locale` 언어와 일치하는 POI의 현지화된 이름 값을 제공합니다.
'description' 필드의 기본 언어가 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`description.default_locale`	아니요	속성 설명에 유효한 BCP 47 기본 언어를 지정하세요.
'설명' 필드에 기본 현지화가 없습니다.	ERROR	`MISSING_REQUIRED_FIELD`	`description.localizations`	아니요	선언된 `default_locale` 언어와 일치하는 설명 텍스트를 제공하세요.
'display_address' 필드의 기본 언어가 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`display_address.default_locale`	아니요	표시 주소에 유효한 BCP 47 기본 언어를 지정하세요.
'display_address' 필드에 기본 현지화가 없습니다.	ERROR	`MISSING_REQUIRED_FIELD`	`display_address.localizations`	아니요	선언된 `default_locale` 언어와 일치하는 형식의 주소 텍스트를 제공합니다.
최대 이미지 수 초과	WARNING	`EXCEEDED_MAX_COUNT`	`images`	아니요	이미지 항목은 관심 장소당 최대 5개로 제한합니다. 초과한 이미지는 삭제됩니다.
잘못된 위도 좌표	ERROR	`INVALID_LATLNG`	`location.latitude`	아니요	`-90.0`에서 `+90.0` 사이의 유효한 위도를 입력하세요. 지리 좌표 정의를 참고하세요.
잘못된 경도 좌표	ERROR	`INVALID_LATLNG`	`location.longitude`	아니요	`-180.0`에서 `+180.0` 사이의 유효한 경도를 입력하세요. 지리 좌표 정의를 참고하세요.
위도 좌표 누락	ERROR	`MISSING_REQUIRED_FIELD`	`location.latitude`	아니요	좌표 쌍을 완성하려면 위도 값을 입력하세요. 지리 좌표 정의를 참고하세요.
경도 좌표 누락	ERROR	`MISSING_REQUIRED_FIELD`	`location.longitude`	아니요	좌표 쌍을 완성하려면 경도 값을 입력하세요. 지리 좌표 정의를 참고하세요.
누락되거나 구조화되지 않은 주소	ERROR	`MISSING_REQUIRED_FIELD`	`location.address`	아니요	도로명, 지역, 우편번호, 국가를 포함한 체계적인 우편 주소를 제공합니다.
형식이 잘못되었거나 잘못된 URL	ERROR	`INVALID_ATTRIBUTE_VALUE`	`url`	아니요	방문 페이지 URL이 지원되는 HTTP/HTTPS 프로토콜과 유효한 문법을 사용하는지 확인하세요.
잘못되었거나 액세스할 수 없는 이미지	WARNING	`INVALID_IMAGE`	`image.url`	아니요	이미지 URL이 공개적으로 연결 가능하고 인증이 필요하지 않거나 4xx/5xx 오류를 반환하지 않는지 확인합니다.
중복 관심 장소 ID	ERROR	`DUPLICATE_ENTITY`	`poi_id`	아니요	각 `poi_id`는 피드 페이로드 전체에서 고유해야 합니다. 중복된 항목을 삭제합니다.
중복 일치 항목	ERROR	`DUPLICATE_MATCHED_ENTITY`	`POI`	아니요	피드에서 중복 항목을 삭제하거나 관심 장소 항목 일치 도구를 사용하여 개별 비즈니스를 독립적인 Google 지도 등록정보와 일치시킵니다.
일치하지 않는 항목	ERROR	`UNMATCHED_ENTITY`	`POI`	아니요	관심 장소 항목 일치 도구를 사용하여 관심 장소를 Google 지도 장소 등록정보와 일치시킵니다.
이미지 정책 위반	ERROR	`SAFE_SEARCH_POLICY_VIOLATION_IMAGE`	`image`	예	플래그가 지정된 이미지를 삭제하거나 교체하거나 이의신청을 클릭하여 근거를 제출합니다. Google 검색 콘텐츠 이미지 정책을 참고하세요.
텍스트 정책 위반 - 기본 이름	ERROR	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`name.localizations.*.text`	예	플래그가 지정된 이름 텍스트를 삭제하거나 교체하거나 이의신청을 클릭합니다. Google 검색 콘텐츠 텍스트 정책을 참고하세요.
텍스트 정책 위반 - 기본 이름이 아님	WARNING	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`name.localizations.*.text`	아니요	플래그가 지정된 이름 텍스트를 삭제하거나 교체합니다. Google 검색 콘텐츠 텍스트 정책을 참고하세요.
텍스트 정책 위반 - 설명	WARNING	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`description.localizations.*.text`	아니요	플래그가 지정된 설명 텍스트를 삭제하거나 교체합니다. Google 검색 콘텐츠 텍스트 정책을 참고하세요.
텍스트 정책 위반 - 표시 주소	WARNING	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`display_address.localizations.*.text`	아니요	플래그가 지정된 표시 주소 텍스트를 삭제하거나 교체하세요. Google 검색 콘텐츠 텍스트 정책을 참고하세요.
시설 카테고리의 기본 언어가 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.establishment_category.default_locale`	아니요	선언된 `default_locale` 언어와 일치하는 관심 장소의 현지화된 시설 카테고리 값을 제공합니다.
영업시간 영업일 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.open_day`	아니요	올바른 영업시간 시작일을 입력하세요.
영업시간 시작 시간이 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.open_time`	아니요	유효한 영업시간을 입력하세요.
영업시간 휴무일 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.close_day`	아니요	올바른 영업시간 종료일을 입력하세요.
영업시간 종료 시간이 누락됨	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.close_time`	아니요	올바른 영업시간 종료 시간을 입력하세요.
영업시간의 시작 시간이 종료 시간보다 늦음	ERROR	`NOT_LESS_THAN_FIELD`	`local_data.business_hours.time_ranges.open_time`, `local_data.business_hours.time_ranges.close_time`	아니요	유효한 영업 시작 시간과 종료 시간 쌍을 제공하고 영업 시작 시간이 종료 시간보다 이른지 확인하세요.
가격대 최솟값이 최댓값보다 큼	ERROR	`INVALID_PRICE_RANGE`	`local_data.price_range.min_price`, `local_data.price_range.max_price`	아니요	최저 가격이 최고 가격보다 낮은 유효한 가격 범위를 제공하세요.
브랜드 ID 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.brand_id`	아니요	유효한 브랜드 ID를 입력하세요.
관심 장소 내 중복된 브랜드 ID	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.brand_id`	아니요	각 `brand_id`는 관심 장소 페이로드 전체에서 고유해야 합니다. 중복된 항목을 삭제합니다.
브랜드 기본 URL 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.default_url`	아니요	유효한 브랜드 기본 URL을 입력하세요.
형식이 잘못되었거나 잘못된 브랜드 URL	ERROR	`INVALID_ATTRIBUTE_VALUE`	`local_data.brand_landing_pages.default_url`	아니요	브랜드 기본 URL이 지원되는 HTTP/HTTPS 프로토콜과 유효한 문법을 사용하는지 확인합니다.
브랜드의 현지화된 방문 페이지 URL 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.localized_landing_pages.url`	아니요	현지화된 방문 페이지에 유효한 URL을 제공합니다.
브랜드 현지화 방문 페이지 URL의 형식이 잘못되었거나 잘못됨	ERROR	`INVALID_ATTRIBUTE_VALUE`	`local_data.brand_landing_pages.localized_landing_pages.url`	아니요	현지화된 방문 페이지 URL이 지원되는 HTTP/HTTPS 프로토콜과 유효한 문법을 사용하는지 확인합니다.
중복된 브랜드 현지화 방문 페이지 URL	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.localized_landing_pages.url`	아니요	각 `url`는 관심 장소 현지화 방문 페이지 전체에서 고유해야 합니다. 중복된 항목을 삭제합니다.
브랜드 현지화 방문 페이지 언어 누락	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.localized_landing_pages.locales`	아니요	현지화된 방문 페이지에 유효한 언어 세트를 제공하세요.
중복된 브랜드 현지화 방문 페이지 언어	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.localized_landing_pages.locales`	아니요	각 `locale`는 관심 장소 현지화 방문 페이지 전체에서 고유해야 합니다. 중복된 항목을 삭제합니다.
텍스트 정책 위반 - 시설 카테고리	WARNING	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`local_data.establishment_category.localizations.*.text`	아니요	플래그가 지정된 시설 카테고리 텍스트를 삭제하거나 교체합니다. Google 검색 콘텐츠 텍스트 정책을 참고하세요.

문제 코드

다음 섹션에서는 각 문제 코드의 자세한 원인과 해결 단계를 설명합니다.

필수 입력란이 누락되었습니다.

문제 코드: MISSING_REQUIRED_FIELD
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (POI 피드를 업데이트하여 해결)

이 오류는 처리된 항목에 관심 장소 피드 사양에 필요한 필수 속성이 하나 이상 누락된 경우에 발생합니다.

문제 세부정보 패널을 확인하여 누락된 특정 속성을 파악한 후 해당 수정사항을 적용합니다.

1. 관심 장소 ID (`poi_id`) 누락

원인: poi_id 필드가 비어 있거나 null이거나 루트 항목 객체에서 누락되었습니다.
해결 방법: 속성에 영구적이고 고유한 문자열 식별자를 제공합니다.

{
  "poi_id": "test_restaurant_1"
}

2. 기본 언어 또는 현지화된 이름 누락 (`name`)

원인: name 객체에 일치하는 언어가 있는 default_locale 문자열 또는 localizations 배열이 누락되었습니다.
해결 방법: default_locale과 해당 언어와 일치하는 현지화 항목을 하나 이상 제공합니다.

{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. 기본 언어 또는 현지화된 주소 누락 (`display_address`)

원인: display_address 객체에 default_locale 문자열 또는 localizations 배열이 누락되었습니다.
해결 방법: default_locale와 해당 언어에 일치하는 상세 주소의 현지화 항목을 하나 이상 제공합니다.

{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. 기본 언어 또는 현지화된 설명 누락 (`description`)

원인: description 객체가 포함된 경우 default_locale 또는 일치하는 현지화가 누락됩니다.
해결 방법: 설명에 default_locale 및 해당 언어와 일치하는 현지화 항목을 하나 이상 제공합니다.

{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. 지리적 좌표 누락 (`location.latitude` / `location.longitude`)

원인: location 객체에 latitude 또는 longitude 숫자 값이 누락되었습니다.
해결 방법: latitude 및 longitude를 모두 표준 WGS84 십진법 각도의 부동 소수점 숫자로 제공합니다.

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. 구조화된 우편 주소 누락 (`location.address`)

원인: location.address 객체에 필수 주소 구성요소 (country, locality 또는 postal_code)가 누락되었습니다.
해결 방법: ISO 표준에 따라 구조화된 우편 주소 객체를 채웁니다.

{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. 시설 카테고리 (`local_data.establishment_category.default_locale`)의 기본 언어가 누락됨

원인: local_data.establishment_category 객체가 있지만 default_locale가 누락되었거나 비어 있거나 localizations 배열의 항목과 일치하지 않습니다.
해결 방법: default_locale에 유효한 BCP 47 언어 태그를 지정하고 해당 언어와 일치하는 현지화된 문자열을 하나 이상 제공합니다.

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. 영업시간 영업일 누락 (`local_data.business_hours.time_ranges.open_day`)

원인: local_data.business_hours.time_ranges의 항목에 open_day가 누락되었거나 DAY_OF_WEEK_UNSPECIFIED로 설정되어 있습니다.
해결: 유효한 요일 문자열 (예: "MONDAY", "TUESDAY" 등)을 제공합니다.

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. 영업시간 시작 시간 누락 (`local_data.business_hours.time_ranges.open_time`)

원인: local_data.business_hours.time_ranges의 항목에 open_time 객체가 누락되었습니다.
해결: open_time를 hours (0~23) 및 minutes(0~59)로 지정합니다.

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. 영업시간 휴무일 누락 (`local_data.business_hours.time_ranges.close_day`)

원인: local_data.business_hours.time_ranges의 항목에 close_day가 누락되었거나 DAY_OF_WEEK_UNSPECIFIED로 설정되어 있습니다.
해결: 유효한 요일 문자열 (예: "MONDAY", "TUESDAY" 등)을 제공합니다.

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. 영업시간 종료 시간 누락 (`local_data.business_hours.time_ranges.close_time`)

원인: local_data.business_hours.time_ranges의 항목에 close_time 객체가 누락되었습니다.
해결: close_time를 hours (0~23) 및 minutes(0~59)로 지정합니다.

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. 브랜드 ID (`local_data.brand_landing_pages.brand_id`) 누락

원인: local_data.brand_landing_pages의 항목에 비어 있거나 null이거나 누락된 brand_id가 있습니다.
해결 방법: 등록된 파트너 브랜드 구성과 일치하는 비어 있지 않은 문자열 식별자를 제공합니다.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. 브랜드 기본 URL (`local_data.brand_landing_pages.default_url`) 누락

원인: local_data.brand_landing_pages의 항목에 default_url가 누락되었거나 빈 문자열입니다.
해결 방법: 현지화된 URL과 일치하지 않는 언어를 사용하는 사용자를 위해 유효한 대체 HTTP/HTTPS 방문 페이지 URL을 제공합니다.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. 브랜드 현지화 방문 페이지 URL (`local_data.brand_landing_pages.localized_landing_pages.url`)이 누락됨

원인: localized_landing_pages 내 항목에 url 필드가 누락되었거나 비어 있습니다.
해결 방법: 현지화된 방문 페이지에 유효한 정규화된 HTTP/HTTPS URL을 제공합니다.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. 브랜드 현지화 방문 페이지 언어 (`local_data.brand_landing_pages.localized_landing_pages.locales`) 누락

원인: localized_landing_pages 내 항목에 locales 배열이 누락되었거나 비어 있습니다.
해결 방법: locales 배열에 하나 이상의 유효한 BCP 47 언어 또는 언어 코드(예: ["en-US"])를 제공합니다.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

최대 이미지 수 초과

문제 코드: EXCEEDED_MAX_COUNT
심각도: 경고
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 오류는 관심 장소 항목 페이로드의 images 배열에 이미지 객체가 5개를 초과하여 포함된 경우에 발생합니다.

해결:

images 배열을 잘라 숙박 시설을 대표하는 고화질 사진을 최대 5개 포함합니다.
한도인 5개를 초과하는 이미지는 삭제됩니다.

잘못된 지리적 좌표

문제 코드: INVALID_LATLNG
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 오류는 location.latitude 또는 location.longitude에 제공된 지리적 좌표가 유효한 구형 경계를 벗어나거나 채워지지 않은 null 좌표를 나타내는 경우에 발생합니다.

일반적인 원인 및 해결 방법:

범위를 벗어난 위도: 위도는 -90.0에서 90.0 사이의 부동 소수점 수여야 합니다.
경도 범위 초과: 경도는 -180.0에서 180.0 사이의 부동 소수점 수여야 합니다(양 끝값 포함).
Null Island (0,0): 0.0, 0.0 또는 자리표시자 정수 (예: 999, 999)를 제출하면 좌표가 거부됩니다.
좌표 바뀜: 직렬화 파이프라인에서 위도와 경도가 반전되지 않았는지 확인합니다.

유효한 페이로드 예시:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

잘못된 형식 또는 잘못된 URL

문제 코드: INVALID_ATTRIBUTE_VALUE
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 오류는 속성 값이 스키마 유효성 검사에 실패할 때 발생하며, 가장 일반적으로 파트너 방문 페이지 URL 또는 이미지 URL의 구문이 잘못된 경우에 발생합니다.

요건:

프로토콜: URL은 http:// 또는 https://를 명시적으로 지정해야 합니다 (HTTPS를 사용하는 것이 좋습니다).
인코딩: 특수문자, 공백 또는 ASCII가 아닌 문자가 포함된 URL은 올바르게 퍼센트 인코딩되어야 합니다 (RFC 3986).
표준 도메인: 도메인이 정규화되었는지 확인합니다 (예: https://example.com/local/123, example.com/local/123 또는 www.example 아님).

유효한 페이로드 예시:

{
  "url": "https://www.tastybitestest.com/en"
}

잘못되었거나 연결할 수 없는 이미지

문제 코드: INVALID_IMAGE
심각도: 경고
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 경고는 Google 크롤러가 image.url에서 미디어 애셋을 다운로드, 디코딩 또는 확인할 수 없는 비동기 이미지 가져오기 단계에서 발생합니다. 잘못된 이미지는 생략되지만 숙박 시설은 계속 게재될 수 있습니다.

일반적인 원인 및 해결 방법:

HTTP 오류 (404 / 403 / 500): 이미지 URL이 200이 아닌 HTTP 상태 코드를 반환합니다. 인증, 쿠키 벽 또는 IP 허용 목록 제한 없이 이미지를 공개적으로 액세스할 수 있는지 확인합니다.
Robots.txt 차단: 콘텐츠 전송 네트워크 (CDN)에서 Googlebot 및 Googlebot-Image 사용자 에이전트를 허용하는지 확인합니다.
지원되지 않는 파일 형식: 이미지는 표준 래스터 형식(JPEG, PNG, WebP)이어야 합니다. 애니메이션 GIF, SVG, 원시 카메라 형식은 지원되지 않습니다. 자세한 내용은 이미지 가이드라인을 참고하세요.
SSL 인증서 실패: 이미지 호스트 서버에 유효한 SSL 인증서 체인이 있는지 확인합니다.

중복된 관심 장소 ID

문제 코드: DUPLICATE_ENTITY
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 오류는 동일한 poi_id 문자열이 단일 피드 파일 세트 내에 두 번 이상 표시될 때 발생합니다.

해결:

피드의 모든 지역 등록정보에 고유하고 결정론적인 poi_id가 있는지 확인합니다.
지역 숙박 시설에 여러 객실 유형 또는 요금이 있는 경우 동일한 ID를 가진 중복된 항목 레코드를 내보내는 대신 단일 루트 관심 장소 항목으로 통합합니다.

중복 일치 항목

문제 코드: DUPLICATE_MATCHED_ENTITY
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하거나 관심 장소 항목 일치 도구를 사용하여 해결)

이 오류는 피드에 있는 두 개 이상의 고유한 poi_id 항목이 동일한 표준 Google 지도 장소 등록정보와 일치하는 경우에 발생합니다. 여러 비즈니스가 동일한 Google 항목에 매핑되면 중복이 해결될 때까지 충돌하는 모든 항목의 게재가 차단됩니다.

해결 방법:

충돌하는 속성 식별: Ingestion Viewer(Ingestion > History)를 열고 최신 수집 실행을 선택한 후 Validations 패널을 펼칩니다. 동일한 문제 정보 그룹 식별자를 공유하는 DUPLICATE_MATCHED_ENTITY 행을 클릭하여 동일한 Google 항목과 일치하는 모든 poi_id 레코드를 확인합니다.
피드에서 중복 등록정보 삭제: 충돌하는 poi_id 항목이 동일한 오프라인 비즈니스 위치를 나타내는 경우 해당 시설에 대해 하나의 poi_id만 제출되도록 피드에서 중복 항목을 삭제합니다.
독립 비즈니스의 잘못된 일치 조정: 충돌하는 poi_id 항목이 동일한 Google 항목과 잘못 일치된 별도의 독립 비즈니스를 나타내는 경우 인벤토리 보기에서 잘못 일치된 비즈니스를 열고 일치 수정을 클릭하여 전용 Google 지도 장소 등록정보를 선택하거나 제안합니다. 자세한 안내는 관심 장소 항목 일치 가이드에서 확인할 수 있습니다.

일치하지 않는 항목

문제 코드: UNMATCHED_ENTITY
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (POI 엔티티 일치 도구를 사용하거나 엔티티 메타데이터를 수정하세요)

이 문제는 Google의 일치 파이프라인이 지역 등록정보를 Google 지도의 표준 장소와 조정할 수 없음을 나타냅니다.

해결 방법:

핵심 속성 확인: 숙박 시설의 name, display_address, location.address, url, telephone, location.latitude/location.longitude가 실제 숙박 시설 위치를 정확하게 반영하는지 확인합니다.
일치 정보 검사: 인벤토리 뷰의 일치 정보 열을 확인하여 후보 장소를 확인합니다.
관심 장소 일치 수정 도구 사용: Actions Center에서 일치 수정을 클릭하여 올바른 Google 장소 ID를 수동으로 검색하고 확인합니다. 자세한 내용은 관심 장소 항목 일치 가이드를 참고하세요.

Google 검색 이미지 정책 위반

문제 코드: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
심각도: 오류 (게재 차단)
이의신청 가능 여부: 가능

관련 정책 문제 코드 보기: Google 검색 콘텐츠 이미지 정책

이미지가 잘못 신고되었다고 생각되면 (거짓양성) 문제 세부정보 패널에서 이의신청 만들기를 클릭합니다.

Google 검색 콘텐츠 텍스트 정책 위반 - 이름

문제 코드: SAFE_SEARCH_POLICY_VIOLATION_TEXT
심각도: 심각도는 필드마다 다름 (다음 세부정보 참고)
영향을 받는 필드: name.localizations.*.text
이의신청 가능 여부: 예 (기본 언어 오류만 해당), 아니요 (기본 언어가 아닌 경우 경고)

기본 언어 (name.default_locale): 오류 (게재 차단) 전체 POI가 게재되지 않도록 차단됩니다. 기본 언어 이름 텍스트가 잘못 신고되었다고 생각되면 (거짓양성) 문제 세부정보 패널에서 이의신청 만들기를 클릭합니다.
기본이 아닌 언어: 경고 (게재를 차단하지 않음) 플래그가 지정된 현지화만 생략되고 관심 장소는 계속 게재될 수 있습니다. 기본이 아닌 언어에 대한 경고는 이의신청할 수 없으며 피드 페이로드를 업데이트하여 해결할 수 있습니다.

관련 정책 문제 코드 보기: Google 검색 콘텐츠 텍스트 정책

Google 검색 콘텐츠 텍스트 정책 위반 - 설명

문제 코드: SAFE_SEARCH_POLICY_VIOLATION_TEXT
심각도: 경고 (게재를 차단하지 않음)
영향을 받는 필드: description.localizations.*.text
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)

이 경고는 description.localizations의 텍스트 사본이 Google 검색 콘텐츠 텍스트 정책을 위반하는 것으로 신고될 때 발생합니다. 플래그가 지정된 설명 현지화 (또는 기본 언어에 플래그가 지정된 경우 전체 description 필드)는 생략되지만 관심 장소는 계속 게재될 수 있습니다.

관련 정책 문제 코드 보기: Google 검색 콘텐츠 텍스트 정책

Google 검색 콘텐츠 텍스트 정책 위반 - 표시 주소

문제 코드: SAFE_SEARCH_POLICY_VIOLATION_TEXT
심각도: 경고 (게재를 차단하지 않음)
영향을 받는 필드: display_address.localizations.*.text
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)

이 경고는 display_address.localizations의 형식화된 주소 텍스트에 Google 검색 콘텐츠 텍스트 정책에서 금지된 콘텐츠가 포함된 경우에 발생합니다. 플래그가 지정된 주소 현지화 (또는 기본 언어가 플래그가 지정된 경우 전체 display_address 필드)는 생략되지만 관심 장소는 계속 게재될 수 있습니다.

관련 정책 문제 코드 보기: Google 검색 콘텐츠 텍스트 정책

영업시간의 시작 시간이 종료 시간보다 늦습니다.

문제 코드: NOT_LESS_THAN_FIELD
심각도: 오류 (게재 차단)
영향을 받는 필드: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)

이 오류는 영업시간 open_time가 같은 날짜 간격의 close_time보다 이후이거나 같은 경우에 발생합니다.

일반적인 원인 및 해결 방법:

당일 반전: open_time이 close_time보다 이전인지 확인합니다(예: 09:00~17:00).
야간 근무: 시설이 하루에 문을 열고 자정을 지나 다음 날에 문을 닫는 경우 (예: 21:00~02:00) close_day를 다음 날로 설정합니다 (예: open_day: "FRIDAY", close_day: "SATURDAY").

유효한 페이로드 예시:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

가격 범위 최솟값이 최댓값보다 큽니다.

문제 코드: INVALID_PRICE_RANGE
심각도: 오류 (게재 차단)
영향을 받는 필드: local_data.price_range.min_price, local_data.price_range.max_price
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)

이 오류는 min_price가 max_price 값을 초과하거나 min_price 및 max_price가 다른 통화 코드를 지정하는 경우에 발생합니다.

일반적인 원인 및 해결 방법:

반전된 값: min_price가 max_price보다 작거나 같은지 확인합니다.
통화 불일치: min_price.currency_code 및 max_price.currency_code가 모두 동일한 ISO 4217 3자리 통화 코드(예: "USD")와 일치하는지 확인합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

관심 장소 내 중복된 고유 속성

문제 코드: DUPLICATE_UNIQUE_PROPERTY
심각도: 오류 (게재 차단)
이의신청 가능 여부: 불가 (피드 페이로드를 업데이트하여 해결)

이 오류는 단일 관심 장소 항목에서 고유해야 하는 필드 또는 하위 요소에 중복 항목이 포함된 경우에 발생합니다.

문제 세부정보 패널을 확인하여 고유성을 위반하는 속성을 식별합니다.

1. 관심 장소 내 중복된 브랜드 ID (`local_data.brand_landing_pages.brand_id`)

원인: 단일 관심 장소의 여러 brand_landing_pages 항목에 동일한 brand_id 문자열이 표시됩니다.
해결 방법: 해당 브랜드의 모든 방문 페이지를 단일 brand_landing_pages 객체로 통합합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. 중복된 브랜드 현지화 방문 페이지 URL (`local_data.brand_landing_pages.localized_landing_pages.url`)

원인: 동일한 방문 페이지 URL이 동일한 브랜드의 localized_landing_pages 아래에 여러 번 정의되어 있습니다.
해결 방법: 각 URL 항목이 고유한지 확인하거나 단일 URL 항목의 locales 배열 아래에 여러 언어를 연결합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. 중복된 브랜드 현지화 방문 페이지 언어 (`local_data.brand_landing_pages.localized_landing_pages.locales`)

원인: 동일한 브랜드의 localized_landing_pages에 있는 여러 항목에서 동일한 언어 코드 (예: "en-US")가 반복됩니다.
해결 방법: 각 언어 태그를 정확히 하나의 현지화된 방문 페이지에 할당합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

브랜드 URL 형식이 잘못되었거나 잘못된 브랜드 URL

문제 코드: INVALID_ATTRIBUTE_VALUE
심각도: 오류 (게재 차단)
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)
영향을 받는 필드: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

이 오류는 브랜드 기본 URL 또는 현지화된 방문 페이지 URL이 URI 문법 검사에 실패할 때 발생합니다.

요건:

프로토콜: http:// 또는 https://를 명시적으로 지정해야 합니다 (프로덕션 서빙에는 https://가 필요함).
문법: 정규화된 도메인 이름이 있는 유효한 퍼센트 인코딩 RFC 3986 준수 URL이어야 합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Google 검색 콘텐츠 텍스트 정책 위반 - 시설 카테고리

문제 코드: SAFE_SEARCH_POLICY_VIOLATION_TEXT
심각도: 경고 (게재를 차단하지 않음)
이의신청 가능 여부: 아니요 (피드 페이로드를 업데이트하여 해결)
영향을 받는 필드: local_data.establishment_category.localizations.*.text

이 경고는 현지화된 업체 카테고리 텍스트가 자동 세이프서치 콘텐츠 필터를 통과하지 못할 때 발생합니다. 플래그가 지정된 시설 카테고리 현지화 (또는 기본 언어가 플래그가 지정된 경우 전체 establishment_category 필드)는 생략되지만 관심 장소는 계속 게재될 수 있습니다.

해결:

정책 준수: 플래그가 지정된 시설 카테고리 텍스트를 삭제하거나 Google 검색 콘텐츠 텍스트 정책을 준수하는 표준 비즈니스 카테고리 용어로 대체합니다.

유효한 페이로드 예시:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}

관심 장소 엔티티 일치

인벤토리 뷰 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

개요

인벤토리 표 열

관심 장소 세부정보 보기

1. 기본 정보

2. 광고 현황

3. 일치 정보

4. 원시 JSON

문제 및 분류 워크플로

문제 유형: 이의신청 가능 여부

지역 애그리게이터 단위 문제 카탈로그

문제 코드

필수 입력란이 누락되었습니다.

1. 관심 장소 ID (poi_id) 누락

2. 기본 언어 또는 현지화된 이름 누락 (name)

3. 기본 언어 또는 현지화된 주소 누락 (display_address)

4. 기본 언어 또는 현지화된 설명 누락 (description)

5. 지리적 좌표 누락 (location.latitude / location.longitude)

6. 구조화된 우편 주소 누락 (location.address)

7. 시설 카테고리 (local_data.establishment_category.default_locale)의 기본 언어가 누락됨

8. 영업시간 영업일 누락 (local_data.business_hours.time_ranges.open_day)

9. 영업시간 시작 시간 누락 (local_data.business_hours.time_ranges.open_time)

10. 영업시간 휴무일 누락 (local_data.business_hours.time_ranges.close_day)

11. 영업시간 종료 시간 누락 (local_data.business_hours.time_ranges.close_time)

12. 브랜드 ID (local_data.brand_landing_pages.brand_id) 누락

13. 브랜드 기본 URL (local_data.brand_landing_pages.default_url) 누락

14. 브랜드 현지화 방문 페이지 URL (local_data.brand_landing_pages.localized_landing_pages.url)이 누락됨

15. 브랜드 현지화 방문 페이지 언어 (local_data.brand_landing_pages.localized_landing_pages.locales) 누락

최대 이미지 수 초과

해결:

잘못된 지리적 좌표

일반적인 원인 및 해결 방법:

잘못된 형식 또는 잘못된 URL

요건:

잘못되었거나 연결할 수 없는 이미지

일반적인 원인 및 해결 방법:

중복된 관심 장소 ID

해결:

중복 일치 항목

해결 방법:

일치하지 않는 항목

해결 방법:

Google 검색 이미지 정책 위반

Google 검색 콘텐츠 텍스트 정책 위반 - 이름

Google 검색 콘텐츠 텍스트 정책 위반 - 설명

Google 검색 콘텐츠 텍스트 정책 위반 - 표시 주소

영업시간의 시작 시간이 종료 시간보다 늦습니다.

일반적인 원인 및 해결 방법:

가격 범위 최솟값이 최댓값보다 큽니다.

일반적인 원인 및 해결 방법:

관심 장소 내 중복된 고유 속성

1. 관심 장소 내 중복된 브랜드 ID (local_data.brand_landing_pages.brand_id)

2. 중복된 브랜드 현지화 방문 페이지 URL (local_data.brand_landing_pages.localized_landing_pages.url)

3. 중복된 브랜드 현지화 방문 페이지 언어 (local_data.brand_landing_pages.localized_landing_pages.locales)

브랜드 URL 형식이 잘못되었거나 잘못된 브랜드 URL

요건:

Google 검색 콘텐츠 텍스트 정책 위반 - 시설 카테고리

해결:

인벤토리 뷰

1. 관심 장소 ID (`poi_id`) 누락

2. 기본 언어 또는 현지화된 이름 누락 (`name`)

3. 기본 언어 또는 현지화된 주소 누락 (`display_address`)

4. 기본 언어 또는 현지화된 설명 누락 (`description`)

5. 지리적 좌표 누락 (`location.latitude` / `location.longitude`)

6. 구조화된 우편 주소 누락 (`location.address`)

7. 시설 카테고리 (`local_data.establishment_category.default_locale`)의 기본 언어가 누락됨

8. 영업시간 영업일 누락 (`local_data.business_hours.time_ranges.open_day`)

9. 영업시간 시작 시간 누락 (`local_data.business_hours.time_ranges.open_time`)

10. 영업시간 휴무일 누락 (`local_data.business_hours.time_ranges.close_day`)

11. 영업시간 종료 시간 누락 (`local_data.business_hours.time_ranges.close_time`)

12. 브랜드 ID (`local_data.brand_landing_pages.brand_id`) 누락

13. 브랜드 기본 URL (`local_data.brand_landing_pages.default_url`) 누락

14. 브랜드 현지화 방문 페이지 URL (`local_data.brand_landing_pages.localized_landing_pages.url`)이 누락됨

15. 브랜드 현지화 방문 페이지 언어 (`local_data.brand_landing_pages.localized_landing_pages.locales`) 누락

1. 관심 장소 내 중복된 브랜드 ID (`local_data.brand_landing_pages.brand_id`)

2. 중복된 브랜드 현지화 방문 페이지 URL (`local_data.brand_landing_pages.localized_landing_pages.url`)

3. 중복된 브랜드 현지화 방문 페이지 언어 (`local_data.brand_landing_pages.localized_landing_pages.locales`)