Ürün durumları

Alışveriş ürünlerinizin ayrıntılı durumunu görüntülemek için Product kaynağını kullanabilirsiniz.

Content API ile ürün durumunu ProductStatuses.get yöntemini çağırarak alabilirsiniz. Merchant API sayesinde Accounts.Products kaynağını alarak ürün durumunu öğrenebilirsiniz.

Alışveriş reklamları ve ücretsiz listelemeler politikalarına uymak sizin sorumluluğunuzdadır. Alışveriş reklamları, bu politikaları ihlal eden içerik veya davranış tespit etmemiz durumunda bu politikaları uygulama ve gerekli işlemleri yapma hakkını saklı tutar.

Koşullar

Ürün durumlarını görmek için aşağıdakileri yapmanız gerekir:

• Hesabınızı bir hedefe kaydedin.
• Aşağıdakilerden birinde geçerli bir ülke kodu sağlayın:
  • feedLabel alanı.
  • shipping alanı.
  • Feed düzeyinde.
  • Hesabınızın gönderim ayarları.

Bir ürünün durumunu öğrenme

Bir ürünün durumunu görüntülemek için Accounts.Products kaynağını alın.

Aşağıda örnek bir GET isteği verilmiştir:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

products.get tarafından verilen tüm yanıtlar aşağıdaki alanları içerir:

• creationDate: Ürünün oluşturulduğu tarih.
• lastUpdateDate: Ürünün son güncellenme zamanı.
• googleExpirationDate: Ürünün süresinin dolduğu tarih.
• destinationStatuses: Ürünün amaçlanan hedefleri.
• itemLevelIssues: Ürünle ilişkili tüm sorunların listesi.

itemLevelIssues alanını yalnızca istekte bulunduğunuz sırada üründe öğe düzeyinde sorunlar varsa görürsünüz.

Aşağıda örnek bir JSON yanıtı verilmiştir:

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

Tüm ürün durumlarını listeleme

Tüm ürünlerinizi ve durumlarını görüntülemek için products.list kullanın.

Sorgunuzu hassaslaştırmak için aşağıdaki parametreleri kullanabilirsiniz:

• pageToken: Sonraki sonuç sayfalarını almak için kullanılır. Her sayfada, dizideki bir sonraki sayfayı almak için kullanabileceğiniz bir nextPageToken bulunur.
• maxResults: Sayfa başına maksimum sonuç sayısı.

Aşağıda, isteğe bağlı sorgu parametreleri içeren örnek bir list isteği görebilirsiniz:

GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

Aşağıda örnek bir JSON yanıtı verilmiştir:

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

productstatuses.list çağrısı, verilerinizde herhangi bir değişiklik yapmadığından üretimde test etmek için güvenlidir.

Öğe düzeyindeki sorunlar

Öğe düzeyindeki her sorun aşağıdaki alanları içerir:

• code: Sorunun hata kodu.
• severity: Sorunun önem derecesi.
• resolution: Satıcının sorunu çözüp çözemeyeceğini bildirir.
• attribute: Etkilenen özellik adı.
• reportingContext: Sorunun geçerli olduğu raporlama bağlamı.
• description: Sorunun açıklaması.
• detail: Sorun hakkında daha fazla bilgi verir.
• documentation: Sorunla ilgili dokümanların URL'si.
• applicableCountries: Sorunun hangi ülkelerde ürünü etkilediğini belirtir.