Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khi tệp nguồn cấp dữ liệu của bạn đã sẵn sàng, hãy lưu trữ tệp tại một vị trí an toàn. Google thường xuyên tìm nạp nguồn cấp dữ liệu, thường là một lần mỗi ngày, để đảm bảo nội dung của bạn luôn được cập nhật. Hãy làm việc với người đại diện của Google để chia sẻ thông tin chi tiết về việc lưu trữ và thời điểm tốt nhất để tìm nạp nguồn cấp dữ liệu từ vị trí lưu trữ của bạn.
Đề xuất về cách lưu trữ nguồn cấp dữ liệu
Mặc dù nhà cung cấp dữ liệu có thể tự quyết định cách tốt nhất để lưu trữ nguồn cấp dữ liệu và cấu trúc của nguồn cấp dữ liệu tại vị trí lưu trữ, nhưng sau đây là một số đề xuất về cách cấu trúc nguồn cấp dữ liệu để có thể tìm nạp liền mạch.
Tạo một thư mục có tên là "latest" (không phân biệt chữ hoa chữ thường). Hãy đảm bảo thư mục này được cập nhật bằng các tệp nguồn cấp dữ liệu
JSON hằng ngày và chỉ chứa các tệp mà Google sẽ tìm nạp cho ngày đó tại bất kỳ thời điểm nào.
Không tạo thư mục con nào trong thư mục mới nhất. Giữ hệ phân cấp phẳng, tức là tất cả tệp json phải nằm trực tiếp trong thư mục "mới nhất".
Bạn có thể chọn lưu trữ ít nhất nguồn cấp dữ liệu trong 30 ngày qua trong các thư mục có tên "ngày-giờ". Điều này có thể hữu ích trong trường hợp cần theo dõi vấn đề với phiên bản trước của nguồn cấp dữ liệu hoặc tra cứu siêu dữ liệu đã cung cấp trước đó. Google sẽ không sử dụng các thư mục này theo bất kỳ cách nào.
Đảm bảo thư mục "mới nhất" không có tệp nào có kích thước 0 KB/tệp trống tại bất kỳ thời điểm nào.
Đảm bảo rằng Google luôn có quyền truy cập vào thư mục "mới nhất" để có thể tìm nạp các tệp một cách liền mạch.
Trong trường hợp Google yêu cầu nguồn cấp dữ liệu thử nghiệm, hãy đảm bảo bạn tạo một thư mục riêng để lưu trữ nguồn cấp dữ liệu thử nghiệm. Ví dụ: nếu hệ phân cấp của nguồn cấp dữ liệu chính thức là ../latest/, thì bạn có thể tạo một hệ phân cấp khác cho nguồn cấp dữ liệu thử nghiệm, chẳng hạn như ../staging/latest/.
Phương thức lưu trữ
Bảng dưới đây liệt kê các phương thức lưu trữ nguồn cấp dữ liệu được hỗ trợ và thông tin chi tiết bắt buộc phải chia sẻ với đại diện của Google.
Phương thức
Thông tin chi tiết bắt buộc
Hỗ trợ việc xác thực
Google Cloud Storage (GCS)
(Các) URL của đối tượng, bộ chứa hoặc thư mục GCS
Thông tin xác thực truy cập
Thời điểm tốt nhất để tìm nạp nguồn cấp dữ liệu một lần mỗi ngày
Bạn phải chia sẻ URL Google Cloud Storage với `088794101-100000002-account@partnercontent.gserviceaccount.com`
(quyền Trình xem đối tượng trên Cloud Storage) Xem thêm thông tin chi tiết trong phần
Lưu trữ nguồn cấp dữ liệu trên Google Cloud Storage
HTTPS
(Các) URL máy chủ HTTP
Thông tin xác thực truy cập
Thời điểm tốt nhất để tìm nạp nguồn cấp dữ liệu một lần mỗi ngày
Thời điểm tốt nhất để tìm nạp nguồn cấp dữ liệu một lần mỗi ngày
Tên người dùng và Mật khẩu, hoặc
Tên người dùng, Khoá riêng tư và Cụm mật khẩu khoá riêng tư hoặc
Kết hợp cả hai yếu tố trên
AWS S3
(Các) URL vùng chứa S3 (Ví dụ: S3://mediafeed-bucket/latest)
Khu vực vùng chứa S3 (Ví dụ: EU-WEST-1)
Thông tin xác thực truy cập
Thời điểm tốt nhất để tìm nạp nguồn cấp dữ liệu một lần mỗi ngày
Cả Mã khoá truy cập và Khoá truy cập bí mật hoặc
Bộ chứa S3 có quyền truy cập không giới hạn (không được ưu tiên)
Sau khi bạn tải(các) tệp nguồn cấp dữ liệu lên bằng một trong các phương thức trên, hãy liên hệ với Nhóm hành động đối với nội dung nghe nhìn để xem xét(các) tệp nguồn cấp dữ liệu của bạn.
Lưu trữ nguồn cấp dữ liệu trên Google Cloud Storage
Các bước sau đây minh hoạ cách tải tệp nguồn cấp dữ liệu lên Google Cloud Storage:
Trên trình đơn điều hướng, hãy nhấp vào Bộ nhớ > Trình duyệt.
Nếu bạn chưa đăng ký Google Cloud Storage, hãy nhấp vào Đăng ký dùng thử miễn phí để bắt đầu dùng thử miễn phí. (Bạn chỉ thanh toán cho dịch vụ này sau khi đạt đến ngưỡng thanh toán hoặc sau 30 ngày.)
Sau khi đăng ký dùng thử miễn phí, hãy làm mới trình duyệt để cập nhật màn hình.
Nhấp vào Tạo bộ chứa.
Đặt tên cho bộ chứa rồi nhấp vào Tạo.
Trên trang Chi tiết về bộ chứa, hãy nhấp vào Tải tệp lên.
Trong trình đơn thả xuống, hãy chọn Storage Object Viewer (Trình xem đối tượng trong bộ nhớ) rồi nhấp vào Save (Lưu).
Sau khi bạn tải tệp nguồn cấp dữ liệu lên hệ thống lưu trữ, hãy liên hệ với Nhóm hành động đối với nội dung nghe nhìn để xem xét tệp nguồn cấp dữ liệu của bạn.
[null,null,[],[[["\u003cp\u003eGoogle will fetch your content feed daily, or more frequently for live content, to keep your information current.\u003c/p\u003e\n"],["\u003cp\u003eStructure your feed with a "latest" folder containing daily JSON files for seamless fetching by Google.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally archive past feeds in dated folders for your own tracking purposes.\u003c/p\u003e\n"],["\u003cp\u003eChoose a hosting method from Google Cloud Storage, HTTPS, SFTP, or AWS S3, and share the details with your Google representative.\u003c/p\u003e\n"],["\u003cp\u003eWhen using Google Cloud Storage, ensure the "Storage Object Viewer" permission is granted to the designated Google account for access.\u003c/p\u003e\n"]]],["Host the feed at a secure location for Google to fetch regularly, typically once daily. Structure the feed with a \"latest\" folder containing current JSON feed files, and optionally, \"date-time\" folders for the last 30 days. Supported hosting methods include Google Cloud Storage, HTTPS, SFTP, and AWS S3, each requiring specific details and credentials shared with Google. For Google Cloud Storage, share the bucket URL and grant Storage Object Viewer permission to `088794101-100000002-account@partnercontent.gserviceaccount.com`. Then contact the Media Actions team to review the feed.\n"],null,["# Host the feed file\n\nOnce your feed file is ready, host it at a secure location. Google fetches the feed regularly, typically\nonce a day, to ensure that your content stays up-to-date. Work with your Google representative to\nshare the hosting details and the best time to fetch the feed from your hosted location.\n| **Note:** For certain use cases that require more real time data ingestion, such as Live TV use case where the programing can often update multiple times a day, Google may decide to fetch the feed more than once a day. In such cases, a representative may contact you to determine the best possible times to fetch the feed from your hosted location.\n\nRecommendations for hosting the feed\n------------------------------------\n\nAlthough it's at the discretion of the data provider to determine the best way to host the feed and\nhow the feed is structured at the hosted location, here are some recommendations on how the feed\nshould be structured to enable a seamless fetch.\n\n- Create a folder named \"latest\" (case insensitive). Make sure this folder is updated with the JSON feed files daily and only contains the files that Google should fetch for the day at any given time.\n- Do not create any subfolders under the latest folder. Keep the hierarchy flat i.e. all the json files should be present directly under the \"latest\" folder.\n- Optionally, you can choose to store at least the last 30 days feed in folders named \"date-time\". This can come in handy in case there's a need to track down an issue with the previous version of the feed or lookup previously provided metadata. Google will not use these folders in any way.\n- Make sure the \"latest\" folder does not have any files with 0KB size/empty files at any given time.\n- Make sure that Google always has access to the \"latest\" folder so the files can be fetched in a seamless manner.\n- In case Google requests for a staging feed, make sure a separate folder is created to host the staging feed. For example, if the hierarchy for the production feed is ../latest/, then you can create a different hierarchy for the staging feed, for example, ../staging/latest/.\n\nHosting methods\n---------------\n\nThe table below lists the supported feed hosting methods and the details required to be shared with\nGoogle representatives.\n\n|----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Method** | **Details Required** | **Authentication Support** |\n| Google Cloud Storage (GCS) | - GCS object, bucket or folder URL(s) - Access Credentials - Best time to fetch the feed once daily | - Google Cloud Storage URLs must be shared with \\`088794101-100000002-account@partnercontent.gserviceaccount.com\\` (Storage Object Viewer permission) See more details in [Host the feed on Google Cloud Storage](#host_the_feed_on_google_cloud_storage) section |\n| HTTPS | - HTTP Server URL(s) - Access Credentials - Best time to fetch the feed once daily | - Username **and** Password **or** [HTTP client certificates](https://support.google.com/webmasters/answer/6073543) |\n| SFTP | - SFTP Server URL(s) - Access Credentials - Best time to fetch the feed once daily | - Username **and** Password, **or** - Username, Private Key, **and** Private Key Passphrase **or** - Combination of both of the above |\n| AWS S3 | - S3 Bucket URL(s) (Example: S3://mediafeed-bucket/latest) - S3 Bucket Region (Example: EU-WEST-1) - Access Credentials - Best time to fetch the feed once daily | - Both Access Key ID **and** Secret Access Key **or** - S3 Buckets with unrestricted access (not preferred) |\n\nAfter you upload your feed file(s) using one of the above methods, contact the Media Actions team\nto review your feed file(s).\n\nHost the feed on Google Cloud Storage\n-------------------------------------\n\nThe following steps demonstrates how to upload a feed file on Google Cloud Storage:\n\n1. Log in to [Google Cloud Platform console](https://console.cloud.google.com)\n and click the **Select a project** dropdown menu.\n\n2. In the pop-up window, click **NEW PROJECT**.\n\n3. Name your new project and click **CREATE**.\n\n4. On the navigation menu, click **Storage \\\u003e Browser**.\n\n5. If you haven't already signed up for Google Cloud Storage, click **Sign up for a free trial** to start your free trial. (You pay for this service only after you reach your billing threshold or 30 days have passed.)\n\n6. After signing up for a free trial, refresh the browser to update the screen.\n\n7. Click **Create bucket**.\n\n8. Name your bucket and click **Create**.\n\n9. On the Bucket details page, click **Upload files**.\n\n10. Upload your [feed file](./create-a-feed).\n\n | **Note:** Media Actions expect the feed to be updated regularly. To learn how to programmatically upload files to your Cloud Storage bucket, see this [page](https://cloud.google.com/storage/docs/uploading-objects).\n11. On the Bucket details page, click **Permissions**.\n\n12. Click **Add members**.\n\n13. In the **New members** field, enter the following email address:\n\n 088794101-100000002-account@partnercontent.gserviceaccount.com\n\n14. In the dropdown, select **Storage Object Viewer** and click **Save**.\n\nAfter you upload your feed file to a host system, contact the Media Actions team to review your feed file."]]
